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 Ibase_connect
-
-$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 ibase_connect
+
+<?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.
+
+
+
+
+
+
+