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