Index: phpdoc/fr/functions/ibase.xml diff -u phpdoc/fr/functions/ibase.xml:1.1 phpdoc/fr/functions/ibase.xml:1.2 --- phpdoc/fr/functions/ibase.xml:1.1 Fri Jul 21 03:27:50 2000 +++ phpdoc/fr/functions/ibase.xml Wed Nov 15 06:24:07 2000 @@ -1,366 +1,677 @@ - - Fonctions InterBase - InterBase - - - - Interbase est une base de données populaire, créée par Borland/Inprise. - Pour plus d'informations sur Interbase, allez à - http://www.interbase.com. - Par ailleurs, Interbase vient de rejoindre le mouvement Open Source! - - - - - - ibase_connect - - Ouvre une connexion à une base de données Interbase. - - - - Description - - int ibase_connect - string database - string - username - - string - password - - - - Ouvre une connexion à une base de données Interbase. - - Exemple avec <function>Ibase_connect</function> - -$dbh = ibase_connect ($host, $username, $password); -$stmt = 'SELECT * FROM tblname'; -$sth = ibase_query ($dbh, $stmt); -while ($row = ibase_fetch_object ($sth)) { - print $row->email . "\n"; -} -ibase_close ($dbh); - - - - - Voir aussi : ibase_pconnect. - - - - - - - ibase_pconnect - - Ouvre une connexion persistante à une base de données Interbase. - - - - Description - - int ibase_connect - string database - string - username - - string - password - - - - Ouvre une connexion persistante à une base de données Interbase. - - - Voir aussi ibase_connect. - - - - - - - ibase_close - - Ferme une connexion à une base de données Interbase. - - - - Description - - int ibase_close - int - connection_id - - - - Ferme une connexion à une base de données Interbase. Cette fonction prend comme - argument un identifiant de connexion id retourné par - ibase_connect. - - - - - - - ibase_query - Exécute une requête sur une base Interbase - - - Description - - int ibase_query - int - link_identifier - - string query - int - bind_args - - - - Exécute une requête sur une base Interbase, et retourne un identifiant de - résultat, à utiliser avec ibase_fetch_row, - ibase_free_result et/ou ibase_free_query. - - - - - - - ibase_fetch_row - Lit une ligne dans une base Interbase - - - Description - - int ibase_fetch_row - int result_identifier - - - Retourne la prochaîne ligne spécifiée dans le résultat obtenu de ibase_query. - - - - - - - ibase_fetch_object - Lit une ligne dans une base Interbase dans un objet. - - - Description - - int ibase_fetch_object - int result_id - - - Lit une ligne dans une base Interbase et la place dans un pseudo objet. - Cette fonction prend comme argument un identifiant de résultat obtenu de - ibase_query ou ibase_execute. - - -$dbh = ibase_connect ($host, $username, $password); -$stmt = 'SELECT * FROM tblname'; -$sth = ibase_query ($dbh, $stmt); -while ($row = ibase_fetch_object ($sth)) { - print $row->email . "\n"; -} -ibase_close ($dbh); - - - - - Voir aussi ibase_fetch_row. - - - - - - - ibase_free_result - Libère un résultat. - - - Description - - int ibase_free_result - int result_identifier - - - Libère un résultat créé par ibase_query. - - - - - - - ibase_prepare - - Prépare une requête pour lier les paramètres et l'éxécuter ultérieurement. - - - - Description - - int ibase_prepare - int - link_identifier - - string query - - - Prépare une requête pour lier les paramètres (avec ibase_bind) et - l'éxécuter (avec ibase_execute). - - - - - - - ibase_bind - - Lie les paramètres avec une requête précédemment préparée. - - - - Description - - ibase_bind - int query - - - Lie les paramètres avec une requête précédemment préparée avec - ibase_prepare. - - - - Ibase_bind ne fonctionne actuellement pas avec PHP4 - - - - - - - - ibase_execute - Exécute une requête préparée. - - - Description - - int ibase_execute - int query - - - Execute une requête préparée (et éventuellement liée) par - ibase_prepare (et éventuellement - ibase_bind). - - - - - - - ibase_free_query - - Libère la mémoire reservée par une requête préparée. - - - - Description - - ibase_free_query - int query - - - Libère la mémoire réservée par une requête préparée par - ibase_prepare. - - - - - - - ibase_timefmt - - Fixe le format de date pour les prochaînes requêtes. - - - - Description - - ibase_timefmt - string format - - - Fixe le format de date pour les prochaînes requêtes. - - - - Ibase_timefmt ne fonctionne pas sous PHP4. - - - - - - - - ibase_num_fields - - Retourne le nombre de lignes dans un résultat. - - - - Description - - int ibase_num_fields - int result_id - - - Retourne le nombre de lignes dans un résultat. - - -$dbh = ibase_connect ($host, $username, $password); -$stmt = 'SELECT * FROM tblname'; -$sth = ibase_query ($dbh, $stmt); - -if ( ibase_num_rows($sth) > 0 ) { - while ($row = ibase_fetch_object ($sth)) { - print $row->email . "\n"; - } -} else { - die("Aucun résultat"); -} - -ibase_close ($dbh); - - - - - - Ibase_timefmt ne fonctionne pas encore sous PHP4. - - - - - - - - + + Fonctions InterBase + InterBase + + + + Interbase est une base de données populaire, créée + par Borland/Inprise. Pour plus d'informations sur Interbase, allez à + http://www.interbase.com. + Par ailleurs, Interbase vient de rejoindre le mouvement Open Source! + + + + Le support intégral de InterBase 6 a été ajouté à PHP 4.0. + + + Cette base de données utilise les guillemets simples (') + pour échapper les caractères, un peu comme le fait Sybase. + Ajoutez à votre fichier php.ini la directive + suivante : + + +magic_quotes_sybase = On + + + + + + + + + ibase_connect + + Ouvre une connexion à une base de données Interbase. + + + + Description + + + int ibase_connect + string database + string + username + + string + password + + string + charset + + int + buffers + + int + dialect + + string + role + + + + + ibase_connect établit une connexin avec + un serveur InterBase. database doit être un chemin + valide jusqu'à un fichier de base de donnés sur le serveur sur lequel + il résde. Si le serveur est distant, il faut le préfixer avec un nom + d'hôte 'hostname:' (TCP/IP), '//hostname/' (NetBEUI) ou 'hostname@' (IPX/SPX), + en fonction du protocole de communication utilisé. username + et password peuvent être spécifié dans les directives + de configuration du PHP ibase.default_user et ibase.default_password. + charset est le jeu de caractère par + défaut de la base. buffers est le nombre de + buffer de base à allouer pour le cache serveur. Si il est passé à 0 ou + omis, le serveur choisira de lui-même. dialect selectionne + le dialecte SQL pour les requêtes exécutées avec cette connexion, et par + défaut, il utilise le meilleur dialecte disponible. + + + Si un deuxième appel est fait avec ibase_connect, en + passant les mêmes arguments, une nouvelle connexion ne sera pas ouverte, + mais la connexion déjà ouverte sera retournée. La connexion sera fermée + dès que le script se termine, à moins qu'elle ne soit fermée + explicitement avec ibase_close, durant le script. + + Exemple <function>ibase_connect</function> + +<?php + $dbh = ibase_connect ($host, $username, $password); + $stmt = 'SELECT * FROM tblname'; + $sth = ibase_query ($dbh, $stmt); + while ($row = ibase_fetch_object ($sth)) { + print $row->email . "\n"; + } + ibase_close ($dbh); +?> + + + + + + buffers a été ajouté dans PHP4-RC2. + + + + + dialect a été ajouté dans PHP4-RC2. Il n'est + opérationnel qu'avec les versions InterBase 6 et plus récentes. + + + + + role a été ajouté dans PHP4-RC2. Il n'est + opérationnel qu'avec les versions InterBase 5 et plus récentes. + + + + Voir aussi: ibase_pconnect. + + + + + + + ibase_pconnect + + Ouvre une connexion persistante à une base de données Interbase. + + + + Description + + + int ibase_pconnect + string database + string + username + + string + password + + string + charset + + int + buffers + + int + dialect + + string + role + + + + + ibase_pconnect se comporte similairement à + ibase_connect, avec deux différences + majeures : la première est que, lors de la connexion, la fonction + va essayer de trouver une connexion (perisitante) déjà ouverte. + Si elle la trouve, cette dernière sera retournée, plutôt qu'une + nouvelle connexion. Sinon, une nouvelle connexion sera ouverte. + La deuxième est que la connexion ne sera pas fermée à la fin + du script, mais restera ouverte pour utilisation ultérieure. + (ibase_close ne fermera pas une connexion ouverte + avec ibase_pconnect). Ce type de lien est alors dit + 'persistant'. + + + + buffers a été ajouté dans PHP4-RC2. + + + + + dialect a été ajouté dans PHP4-RC2. Il n'est + opérationnel qu'avec les versions InterBase 6 et plus récentes. + + + + + role a été ajouté dans PHP4-RC2. Il n'est + opérationnel qu'avec les versions InterBase 5 et plus récentes. + + + + Voir aussi ibase_connect pour plus de détails + sur les arguments de cette fonction. + + + + + + + ibase_close + + Ferme une connexion à une base de données Interbase. + + + + Description + + + int ibase_close + int + connection_id + + + + + ibase_close ferme une connexion à une base + de données Interbase. Cette fonction prend comme argument l'identifiant + de connexion connection_id retourné par + ibase_connect. Si connection_id + est omis, la dernière connexion ibase est fermée. Les transactions par + défaut sont validées et les autres sont annulées. + + + + + + + ibase_query + Exécute une requête sur une base Interbase + + + Description + + + int ibase_query + int + link_identifier + + string + query + + int + bind_args + + + + + Exécute une requête sur une base Interbase, et retourne un + identifiant de résultat, à utiliser avec + ibase_fetch_row, ibase_free_result + et/ou ibase_free_query. + + + + Bien que ces fonctions supportent la liaison de variables avec des + paramètres de requêtes, il n'y a pas d'interêt spécial à les + utiliser. Pour des exemples grandeur réelle, voyez + ibase_prepare et ibase_execute. + + + + + + + + ibase_fetch_row + Lit une ligne dans une base Interbase + + + Description + + + array ibase_fetch_row + int + result_identifier + + + + + Retourne la prochaîne ligne spécifiée dans le + résultat obtenu de ibase_query. + + + + + + + ibase_fetch_object + Lit une ligne dans une base Interbase dans un objet. + + + Description + + + object ibase_fetch_object + int + result_id + + + + + Lit une ligne dans une base Interbase et la place dans un pseudo objet. + Cette fonction prend comme argument un identifiant de résultat obtenu de + ibase_query ou ibase_execute. + + +<php + $dbh = ibase_connect ($host, $username, $password); + $stmt = 'SELECT * FROM tblname'; + $sth = ibase_query ($dbh, $stmt); + while ($row = ibase_fetch_object ($sth)) { + print $row->email . "\n"; + } + ibase_close ($dbh); +?> + + + + + Voir aussi ibase_fetch_row. + + + + + + + ibase_field_info + + Lit les informations sur un champs + + + + Description + + + array ibase_field_info + int result + int field number + + + + Retourne un tableau contenant les informations sur un champs + après une requête de SELECT. Le tableau contient les index + name (nom), alias, relation, length (taille), type. + + + + + + + ibase_free_result + Libère un résultat. + + + Description + + + int ibase_free_result + int + result_identifier + + + + + Libère un résultat créé par + ibase_query. + + + + + + + ibase_prepare + + Prépare une requête pour lier les paramètres et l'éxécuter ultérieurement. + + + + Description + + + int ibase_prepare + int + link_identifier + + string query + + + + Prépare une requête pour lier les paramètres + (avec ibase_bind) et l'éxécuter + (avec ibase_execute). + + + + + + + ibase_execute + Exécute une requête préparée. + + + Description + + + int ibase_execute + int + query + + int + bind_args + + + + + Execute une requête préparée (et éventuellement + liée) par ibase_prepare (et éventuellement + ibase_bind). Cette fonction est beaucoup plus efficace + que ibase_query, si vous effectuez plusieurs fois + la même requête, en ne changeant que quelques paramètres. + + +<?php + $updates = array( + 1 => 'Eric', + 5 => 'Filip', + 7 => 'Larry' + ); + + $query = ibase_prepare("UPDATE FOO SET BAR = ? WHERE BAZ = ?"); + + while (list($baz, $bar) = each($updates)) { + ibase_execute($query, $bar, $baz); + } +?> + + + + + + + + + ibase_trans + Prépare une transaction + + + Description + + + int ibase_trans + int + trans_args + + int + link_identifier + + + + + Prépare une transaction + + + + + + + ibase_commit + Valide une transaction + + + Description + + + int ibase_commit + int + link_identifier + + int trans_number + + + + + Valide la transaction trans_number, qui a été + préparée avec ibase_trans. + + + + + + + ibase_rollback + Annule une transaction + + + Description + + + int ibase_rollback + int + link_identifier + + int trans_number + + + + + Annule la transaction trans_number qui a été + préparée avec ibase_trans. + + + + + + + ibase_free_query + + Libère la mémoire reservée par une requête préparée. + + + + Description + + + int ibase_free_query + int + query + + + + + Libère la mémoire réservée par une + requête préparée par ibase_prepare. + + + + + + + ibase_timefmt + + Fixe le format de date pour les prochaînes requêtes. + + + + Description + + + int ibase_timefmt + string + format + + int + columntype + + + + + Fixe le format des colonnes de type dates, heure et timestamp, + retournées par les requêtes. En interne, les colonnes sont formatées + par la fonction C strftime() : reportez vous à sa documentation + pour connaître la structure de la chaîne de format. + columntype est une des constantes suivantes : + IBASE_TIMESTAMP, IBASE_DATE and IBASE_TIME. Si il est omis, + la valeur par défaut est IBASE_TIMESTAMP, pour compatibilité + ascendante. + + +<?php + // Les colonnes TIME de InterBase 6 seront retournées avec + // la forme '05 heures 37 minutes'. + ibase_timefmt("%H heures %M minutes", IBASE_TIME); +?> + + + + + Vous pouvez aussi modifier les formats par défaut avec les directives + PHP ibase.timestampformat, ibase.dateformat et ibase.timeformat. + + + + columntype a été ajouté dans PHP 4.0. Il n'a + aucun sens jusqu'à InterBase version 6 et plus récent. + + + + + Une modification incompatible avec l'existant est apparue + dans PHP 4.0 lorsque la directive PHP ibase.timeformat a été renommée + ibase.timestampformat et les directives ibase.dateformat et + ibase.timeformat ont été ajoutée, de manière à les adapter à leur + fonction. + + + + + + + + ibase_num_fields + + Retourne le nombre de lignes dans un résultat. + + + + Description + + + int ibase_num_fields + int result_id + + + + Retourne le nombre de lignes dans un résultat. + + +<?php +$dbh = ibase_connect ($host, $username, $password); +$stmt = 'SELECT * FROM tblname'; +$sth = ibase_query ($dbh, $stmt); + +if ( ibase_num_rows($sth) > 0 ) { + while ($row = ibase_fetch_object ($sth)) { + print $row->email . "\n"; + } +} else { + die("Aucun résultat"); +} + +ibase_close ($dbh); +?> + + + + + + ibase_timefmt ne fonctionne pas encore sous PHP4. + + + + + + + + ibase_errmsg + + Retourne un message d'erreur + + + + Description + + + string ibase_errmsg + void + + + + Retourne une chaîne contenant les messages d'erreurs. + + + + + + +