Index: phpdoc/fr/functions/ibase.xml diff -u phpdoc/fr/functions/ibase.xml:1.8 phpdoc/fr/functions/ibase.xml:1.9 --- phpdoc/fr/functions/ibase.xml:1.8 Thu Mar 22 05:38:22 2001 +++ phpdoc/fr/functions/ibase.xml Tue Jul 31 04:05:47 2001 @@ -1,92 +1,92 @@ - - 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! + + InterBase + InterBase + + + Interbase est une base de données populaire, créée + par Borland/Inprise. Pour plus d'informations sur Interbase, allez à + &url.ibase;. + Par ailleurs, Interbase vient de rejoindre le mouvement Open Source! + + + + Le support intégral de InterBase 6 a été ajouté + à PHP 4.0. - - - 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 : - - + + 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 - - - resource 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> - + + + + + + + + ibase_connect + + Ouvre une connexion à une base de données Interbase. + + + + Description + + + resource 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. S'il est passé à 0 ou + omis, le serveur choisira de lui-même. dialect + sélectionne 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'; @@ -96,213 +96,215 @@ } ibase_close($dbh); ?> - - + + + + + + buffers a été ajouté en PHP 4-RC2. - - - 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. + dialect a été ajouté en PHP 4-RC2. + Il n'est opérationnel qu'avec les versions InterBase 6 et plus + récentes. - - - - - ibase_pconnect - - Ouvre une connexion persistante à une base de données Interbase. - - - - Description - - - resource 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'. + role a été ajouté en PHP 4-RC2. + Il n'est opérationnel qu'avec les versions InterBase 5 et plus + récentes. - - - 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 + + + resource 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 (peristante) 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'. + + - Voir aussi ibase_connect pour plus de détails - sur les arguments de cette fonction. + buffers a été ajouté en PHP 4-RC2. - - - - - ibase_close - - Ferme une connexion à une base de données Interbase. - - - - Description - - - int ibase_close - resource - connection_id - - - + + + + dialect a été ajouté en PHP 4-RC2. + Il n'est opérationnel qu'avec les versions InterBase 6 et plus + récentes. + + + - 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. + role a été ajouté en PHP 4-RC2. + Il n'est opérationnel qu'avec les versions InterBase 5 et plus + récentes. - - - - - ibase_query - Exécute une requête sur une base Interbase - - - Description - - - resource ibase_query - resource - link_identifier - - string - query - - int - bind_args - - - - - ibase_query 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 - resource - result_identifier - - - - - ibase_fetch_row 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 - resource - result_id - - - + + + 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 + resource + 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 + + + resource ibase_query + resource + link_identifier + + string + query + + int + bind_args + + + + + ibase_query 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_object lit une ligne dans une base - Interbase et la place dans un pseudo objet. ibase_fetch_object - prend comme argument l'identifiant de résultat result_id - obtenu de ibase_query ou ibase_execute. - - + Bien que ces fonctions supportent la liaison de variables avec des + paramètres de requêtes, il n'y a pas d'intérê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 + resource + result_identifier + + + + + ibase_fetch_row retourne la prochaine + 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 + resource + result_id + + + + + ibase_fetch_object lit une ligne dans une base + Interbase et la place dans un pseudo objet. ibase_fetch_object + prend comme argument l'identifiant de résultat result_id + obtenu de ibase_query ou ibase_execute. + + <php $dbh = ibase_connect($host, $username, $password); $stmt = 'SELECT * FROM tblname'; @@ -311,40 +313,42 @@ print $row->email . "\n"; } ibase_close($dbh); -?gt; - - - - - Voir aussi - ibase_fetch_row. - - - - - - ibase_field_info - - Lit les informations sur un champs - - - - Description - - - array ibase_field_info - resource result - int field number - - - - ibase_field_info 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. - - - +?> + + + + + Voir aussi + ibase_fetch_row. + + + + + + ibase_field_info + + Lit les informations sur un champs + + + + Description + + + array ibase_field_info + resource result + int field_number + + + + ibase_field_info retourne un tableau + contenant les informations sur le champs numéro + field_number après une + requête de SELECT. Le tableau contient les index + name (nom), alias, relation, length (taille), type. + + + +<?php // helio <email protected> 08-Dec-2000 02:53 $rs=ibase_query("Select * from unetable"); $coln = ibase_num_fields($rs); @@ -356,83 +360,84 @@ echo "taille: ".$col_info['length']."\n"; echo "type: ".$col_info['type']."\n"; } - - - - - - - ibase_free_result - Libère un résultat. - - - Description - - - int ibase_free_result - resource - result_identifier - - - - - ibase_free_result libère les ressources - liées au résultat result_identifier. - - - - - - ibase_prepare - - Prépare une requête pour lier les paramètres et - l'éxécuter ultérieurement. - - - - Description - - - int ibase_prepare - resource - link_identifier - - string query - - - - ibase_prepare prépare une - requête pour l'éxécuter - - - - - - ibase_execute - Exécute une requête préparée. - - - Description - - - resource ibase_execute - int - query - - int - bind_args - - - - - ibase_execute exécute une requête - préparée (et éventuellement liée) par - ibase_prepare. ibase_execute - est beaucoup plus efficace que ibase_query, si - vous effectuez plusieurs fois la même requête, en ne - changeant que quelques paramètres. +?> + + + + + + + ibase_free_result + Libère un résultat. + + + Description + + + int ibase_free_result + resource + result_identifier + + + + + ibase_free_result libère les ressources + liées au résultat result_identifier. + + + + + + ibase_prepare + + Prépare une requête pour lier les paramètres et + l'éxécuter ultérieurement. + + + + Description + + + int ibase_prepare + resource + link_identifier + + string query + + + + ibase_prepare prépare une + requête pour l'éxécuter + + + + + + ibase_execute + Exécute une requête préparée. + + + Description + + + resource ibase_execute + int + query + + int + bind_args + + + + + ibase_execute exécute une requête + préparée (et éventuellement liée) par + ibase_prepare. ibase_execute + 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', @@ -444,231 +449,231 @@ ibase_execute($query, $bar, $baz); } ?> - - - - - + + + + + - - ibase_trans - Prépare une transaction - - - Description - - - resource ibase_trans - int - trans_args - - resource - link_identifier - - - - - ibase_trans prépare une transaction - - - - - - ibase_commit - Valide une transaction - - - Description - - - int ibase_commit - resource - link_identifier - - resource trans_number - - - - - ibase_commit valide la transaction - trans_number, qui a été - préparée avec ibase_trans. - - - - - - ibase_rollback - Annule une transaction - - - Description - - - int ibase_rollback - resource - link_identifier - - resource trans_number - - - - - ibase_rollback 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 - resource query - - - - ibase_free_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 - - - - - ibase_timefmt 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 ou IBASE_TIME. - Si elle est omise, la valeur par défaut est IBASE_TIMESTAMP, - pour compatibilité ascendante. - - + + ibase_trans + Prépare une transaction + + + Description + + + resource ibase_trans + int + trans_args + + resource + link_identifier + + + + + ibase_trans prépare une transaction + + + + + + ibase_commit + Valide une transaction + + + Description + + + int ibase_commit + resource + link_identifier + + resource trans_number + + + + + ibase_commit valide la transaction + trans_number, qui a été + préparée avec ibase_trans. + + + + + + ibase_rollback + Annule une transaction + + + Description + + + int ibase_rollback + resource + link_identifier + + resource trans_number + + + + + ibase_rollback annule la transaction + trans_number qui a été + préparée avec ibase_trans. + + + + + + ibase_free_query + + Libère la mémoire réservée par une requête + préparée. + + + + Description + + + int ibase_free_query + resource query + + + + ibase_free_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 prochaines requêtes. + + + + Description + + + int ibase_timefmt + string + format + + int + columntype + + + + + ibase_timefmt 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 ou IBASE_TIME. + Si elle est omise, 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. + + - Vous pouvez aussi modifier les formats par défaut avec les directives - PHP ibase.timestampformat, ibase.dateformat et ibase.timeformat. + columntype a été ajouté en PHP 4.0. + Il n'a aucun sens jusqu'à InterBase version 6 et plus récent. - - - 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 - resource result_id - - + + - ibase_num_fields< retourne le nombre - de lignes dans un résultat. - - + Une modification incompatible avec l'existant est apparue + en PHP 4.0 lorsque la directive PHP ibase.timeformat a été + renommée en 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 colonnes dans un résultat. + + + + Description + + + int ibase_num_fields + resource result_id + + + + ibase_num_fields retourne le nombre + de colonnes 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"; + $dbh = ibase_connect ($host, $username, $password); + $stmt = 'SELECT * FROM tblname'; + $sth = ibase_query($dbh, $stmt); + if (ibase_num_fields($sth) > 0) { + while ($row = ibase_fetch_object ($sth)) { + print $row->email . "\n"; + } + } else { + die ("Aucun résultat dans votre requête"); } -} else { - die("Aucun résultat"); -} -ibase_close($dbh); + ibase_close ($dbh); ?> - - + + + + + + ibase_timefmt ne fonctionne pas encore sous PHP4. - - - ibase_timefmt ne fonctionne pas encore sous PHP4. - - - - - - - ibase_errmsg - - Retourne un message d'erreur - - - - Description - - - string ibase_errmsg - void - - - - ibase_errmsg retourne une chaîne - contenant les messages d'erreurs. - - - - + + + + + + ibase_errmsg + + Retourne un message d'erreur + + + + Description + + + string ibase_errmsg + void + + + + ibase_errmsg retourne une chaîne + contenant les messages d'erreurs. + + + +