Index: phpdoc/fr/functions/dba.xml diff -u phpdoc/fr/functions/dba.xml:1.9 phpdoc/fr/functions/dba.xml:1.10 --- phpdoc/fr/functions/dba.xml:1.9 Sat Jul 7 18:22:05 2001 +++ phpdoc/fr/functions/dba.xml Tue Jul 31 03:35:49 2001 @@ -1,81 +1,108 @@ - - DBA - DBA - - - Ces fonctions sont l'interface avec les bases de type Berkeley. - - - C'est une couche générale pour plusieurs bases de - données sur fichiers. En tant que tel, les fonctionnalités - sont limitées à une partie des fonctionnalités des - bases de données modernes, comme - Sleepycat Software's DB2. (A ne pas confondre avec - IBM's DB2 software, qui fonctionne avec ODBC.). - - - Le comportement de certaines fonctions dépends de la base de - données utilisée. Par exemple - dba_optimize et dba_sync - n'auront pas le même effet d'une base à l'autre. - - - Pour ajouter le support d'une base dba, il suffit d'ajouter l'option - de configuration --with adéquate. Les bases suivantes sont supportées : - - - - Dbm est la plus ancienne des base de données de type Berkeley. - Il vaut mieux l'éviter si possible. Les fonctions de - compatibilités codées dans DB2 et gdbm - ne sont pas supportées, car elles ne sont compatibles qu'au - niveau du code source, et ne peuvent pas gérer le format dbm originel. - (--with-dbm). - - - - - ndbm est un nouveau type de dbm plus flexible. Il a cependant - la majorité des limitations du genre. - (--with-ndbm). - - - - - gdbm est la base dbm GNU. - (--with-gdbm). - - - - - db2 est DB2 de Sleepycat Software. Elle se - décrit comme un "ensemble d'outils qui fournissent une base - de données performante, tant pour les applications - indépendantes que pour le client/serveur". - (--with-db2). - - - - - DB3 est le DB3 de Sleepycat Software. - (--with-db3). - - - - - cdb est "un package rapide, robuste, léger, pour créer et - lire des bases de données constantes". C'est l'auteur de qmail qui - l'a écrit, et elle est disponible ici. Puisque - c'est une base constante, elle ne supporte que la lecture. - (--with-cdb). - - - + + DBA + DBA + + + Ces fonctions sont l'interface avec les bases de type Berkeley. + + + C'est une couche générale pour plusieurs bases de + données sur fichiers. En tant que tel, les fonctionnalités + sont limitées à une partie des fonctionnalités des + bases de données modernes, comme + Sleepycat Software's DB2 (A ne pas confondre avec + IBM's DB2 software, qui fonctionne avec ODBC). + + + Le comportement de certaines fonctions dépends de la base de + données utilisée. Par exemple + dba_optimize et dba_sync + n'auront pas le même effet d'une base à l'autre. + + + Lors de l'utilisation de la fonction dba_open ou de + dba_popen, une des librairies suivante doit + être fournie comme argument. La liste complète des librairies + supportées par votre configuration est disponible avec la fonction + phpinfo. (Pour ajouter le support de l'une + de ces librairies, ajouter l'option de configuration + --with-XXXX). +

+ Liste des librairies DBA + + + + Librairie + Notes + + + + + dbm + + Dbm est la plus ancienne des base de données de type Berkeley. + Il vaut mieux l'éviter si possible. Les fonctions de + compatibilités codées dans DB2 et gdbm + ne sont pas supportées, car elles ne sont compatibles qu'au + niveau du code source, et ne peuvent pas gérer le format dbm originel. + (). + + + + ndbm + + ndbm est un nouveau type de dbm plus flexible. Il a cependant + la majorité des limitations du genre. + (). + + + + gdbm + + gdbm est la base dbm GNU. + (). + + + + db2 + + db2 est DB2 de Sleepycat Software. Elle se + décrit comme un "ensemble d'outils qui fournissent une base + de données performante, tant pour les applications + indépendantes que pour le client/serveur". + (). + + + + db3 + + DB3 est le DB3 de Sleepycat Software. + (). + + + + cdb + + cdb est "un package rapide, robuste, léger, pour créer et + lire des bases de données constantes". C'est l'auteur de qmail qui + l'a écrit, et elle est disponible ici. Puisque + c'est une base constante, elle ne supporte que la lecture. + (--with-cdb). + + + + +
Exemple DBA - + <?php $id = dba_open("/tmp/test.db", "n", "db2"); if(!$id) { @@ -89,30 +116,30 @@ } dba_close($id); ?> - - - - - DBA gère les données binaires, et n'a pas de limites arbitraires. - Elle hérite de toutes les limites de la base sous jacentes. - - - Toutes les bases de données sur fichiers doivent fournir un moyen - de changer le mode d'accès au fichier d'une base, et si possible, - de toutes les bases. Le mode d'accès est généralement - passé en 4ème argument à dba_open - ou dba_popen. - - - Vous pouvez accéder à toutes les entrées d'une - base d'une manière linéaire, avec les fonctions - dba_firstkey et dba_nextkey. - Vous ne devez pas modifier une base lorsque vous la traversez ainsi. - - - - Passer en revue une base - + + + + + DBA gère les données binaires, et n'a pas de limites arbitraires. + Elle hérite de toutes les limites de la base sous jacentes. + + + Toutes les bases de données sur fichiers doivent fournir un moyen + de changer le mode d'accès au fichier d'une base, et si possible, + de toutes les bases. Le mode d'accès est généralement + passé en 4ème argument à dba_open + ou dba_popen. + + + Vous pouvez accéder à toutes les entrées d'une + base d'une manière linéaire, avec les fonctions + dba_firstkey et dba_nextkey. + Vous ne devez pas modifier une base lorsque vous la traversez ainsi. + + + + Passer en revue une base + <?php # ...ouverture de la base... $key = dba_firstkey($id); @@ -125,449 +152,483 @@ for($i = 0; $i < count($handle_later); $i++) dba_delete($handle_later[$i], $id); ?> - - + + + + + + + dba_close + Ferme une base. + + + Description + + + void dba_close + resource handle + + + + dba_close ferme le lien établi avec + la base et libère toutes les ressources de handle. + + + handle est un identifiant de base, retourné par + dba_open. + + + dba_close ne retourne aucune valeur. + + + Voir aussi + dba_open et + dba_popen. + + + + + + dba_delete + Efface une entrée. + + + Description + + + bool dba_delete + string key + resource handle + + + + dba_delete efface l'entrée + spécifiée par la clé key, + dans la base identifiée par handle. + + + key est la clé de l'entrée à effacer. + + + handle est un identifiant de lien, retourné par + dba_open. + + + dba_delete retourne TRUE ou + FALSE, si l'entrée est effacée, ou + pas effacée, respectivement. + + + Voir aussi + dba_exists, + dba_fetch, + dba_insert et + dba_replace + + + + + + dba_exists + Vérifie qu'une clé existe. + + + Description + + + boolean dba_exists + string key + resource handle + + + + dba_exists vérifie si la clé + key existe dans la base identifiée + par handle. + + + key est la clé qui doit être + vérifiée. + + + handle est un identifiant de base, retourné par + dba_open. + + + dba_exists retourne TRUE + ou FALSE, si la clé est trouvée, + ou pas, respectivement. + + + Voir aussi + dba_fetch, + dba_delete, + dba_insert et + dba_replace. + + + + + + dba_fetch + Lit les données liées à une clé. + + + Description + + + string dba_fetch + string key + resource handle + + + + dba_fetch lit les données spécifiée + par la clé key dans la base identifiée + par handle. + + + key est la clé dont on veut lire les + données. + + + handle est un identifiant de base, retourné par + dba_open. + + + dba_fetch retourne la chaîne associée ou + FALSE, si la paire clé/valeur n'a pas été + trouvée. + + + Voir aussi + dba_exists, + dba_delete, + dba_insert et + dba_replace. + + + + + + dba_firstkey + Lit la première clé. + + + Description + + + string dba_firstkey + resource handle + + + + dba_firstkey retourne la première clé + de la base de données spécifiée par + handle et y place le pointeur interne de + clé. Cela permettra de traverser la base. + + + handle est un identifiant de base, retourné par + dba_open. + + + dba_firstkey retourne la clé, ou FALSE, + suivant que la première clé existe ou pas. + + + Voir aussi + dba_nextkey + et l'exemple 2 de l'introduction DBA. + + + + + + dba_insert + Insère une entrée. + + + Description + + + boolean dba_insert + string key + string value + resource handle + + + + dba_insert insère l'entrée décrite + par la clé key et la valeur + value dans la base spécifiée + par handle. Si une entrée aveec la même + clé key existe déjà, l'insertion + échouera. + + + key est la clé de la valeur à + insérer. + + + value est la valeur à insérer. + + + handle est un identifiant de base, retourné par + dba_open. + + + dba_insert retourne TRUE ou + FALSE, suivant que l'insertion a réussi ou + échoué. + + + Voir aussi + dba_exists, + dba_delete, + dba_fetch et + dba_replace. + + + + + + dba_nextkey + Lit la clé suivante. + + + Description + + + string dba_nextkey + resource handle + + + + dba_nextkey retourne la clé suivante, + dans la base identifiée par handle et + incrémente le pointeur de clé. + + + handle est un identifiant de base, retourné par + dba_open. + + + dba_nextkey retourne la clé, ou + FALSE en cas d'échec. + + + Voir aussi + dba_firstkey. + + + + + + dba_popen + Ouvre une connexion persistante à une base de données. + + + Description + + + int dba_popen + string path + string mode + string handler + mixed ... + + + + dba_popen établit une connexion persistante + à la base repérée par path + avec le mode mode, en utilisant l'identifiant + handler. + + + path est le chemin sur votre machine. + + + mode vaut "r" pour lecture seule, "w" pour + lecture/écriture, "c" pour lecture/écriture, et + création si la base n'existe pas, et "n" pour + création, écrasement, et accès en + lecture/écriture. + + + handler est le nom de l'identifiant qui sera + utilisé pour accéder à path. + Il est passé à dba_popen. + + + dba_popen retourne un identifiant positif, + ou FALSE, suivant que la base a été ouverte, ou que + l'accès a échoué. + + + Voir aussi + dba_open et + dba_close. + + + + + + dba_open + Ouvre une base de données. + + + Description + + + int dba_open + string path + string mode + string handler + mixed ... + + + + dba_open établit une connexion à + la base repérée par path avec le + mode mode et l'identifiant handler. + + + pathest le chemin sur votre machine. + + + mode vaut "r" pour lecture seule, "w" pour + lecture/écriture, "c" pour lecture/écriture, et + création si la base n'existe pas, et "n" pour + création, écrasement, et accès en + lecture/écriture. + + + handler est le nom de l'identifiant qui + sera utilisé pour accéder à path. + Il est passé à dba_popen. + + + Voir aussi + dba_popen et + dba_close. + + + + + + dba_optimize + Optimise une base. + + + Description + + + boolean dba_optimize + resource handle + + + + dba_optimize optimise la base de données + identifiée par handle. + + + handle est un identifiant de base retourné par + dba_open. + + + dba_optimize retourne TRUE ou + FALSE, suivant que l'optimisation a réussi + ou échoué. + + + Voir aussi + dba_sync. + + + + + + dba_replace + Remplace ou insère une entrée. + + + Description + + + boolean dba_replace + string key + string value + resource handle + + + + dba_replace remplaces ou insère une entrée, + pour la clé key et avec la valeur + value dans la base identifiée par + handle. + + + key est la clé qui va être + insérée. + + + value est la valeur qui va être + insérée. + + + handle est un identifiant de base retourné par + dba_open. + + + dba_replace retourne TRUE ou + FALSE, suivant que l'opération réussit + ou échoue. + + + Voir aussi + dba_exists, + dba_delete, + dba_fetch et + dba_insert. + + + + + + dba_sync + Synchronise une base de données. + + + Description + + + boolean dba_sync + resource handle + + + + dba_sync synchronise la base de données + spécifiée par handle. Si + accepté, cela va probablement lancer une opération + de réécriture physique du fichier. + + + handle est un identifiant de base retourné par + dba_open. + + + dba_sync retourne TRUE ou + FALSE, si la synchronisation réussi, ou + échoue, respectivement. + + + Voir aussi + dba_optimize. - - - - dba_close - Ferme une base. - - - Description - - - void dba_close - resource handle - - - - dba_close ferme le lien établit avec - la base et libère toutes les ressources de handle. - - - handle est un identifiant de base, retourné par - dba_open. - - - dba_close ne retourne aucune valeur. - - - Voir aussi: dba_open et dba_popen. - - - - - - dba_delete - Efface une entrée. - - - Description - - - bool dba_delete - string key - resource handle - - - - dba_delete efface l'entrée - spécifiée par la clé key, - dans la base identifiée par handle. - - - key est la clé de l'entrée à effacer. - - - handle est un identifiant de lien, retourné par - dba_open. - - - dba_delete retourne &true; ou &false;, si l'entrée est - effacée, ou pas effacée, respectivement. - - - Voir aussi: dba_exists, dba_fetch, - dba_insert et dba_replace - - - - - - dba_exists - Vérifie qu'une clé existe. - - - Description - - - bool dba_exists - string key - resource handle - - - - dba_exists vérifie si la clé - key existe dans la base identifiée - par handle. - - - key est la clé qui doit être - vérfiée. - - - handle est un identifiant de base, retourné par - dba_open. - - - dba_exists retourne &true; ou &false;, si la clé est - trouvée, ou pas, respectivement. - - - Voir aussi : dba_fetch, dba_delete, - dba_insert et dba_replace. - - - - - - dba_fetch - Lit les données liées à une clé. - - - Description - - - string dba_fetch - string key - resource handle - - - - dba_fetch lit les données spécifiée - par la clé key dans la base identifiée - par handle. - - - key est la clé dont on veut lire les - données. - - - handle est un identifiant de base, retourné par - dba_open. - - - dba_fetch retourne la chaîne associée ou &false;, - si la paire clé/valeur n'a pas été trouvée. - - - Voir aussi : dba_exists, dba_delete, - dba_insert et dba_replace. - - - - - - dba_firstkey - Lit la première clé. - - - Description - - - string dba_firstkey - resource handle - - - - dba_firstkey retourne la première clé - de la base de données spécifiée par - handle et y place le pointeur interne de - clé. Cela permettra de traverser la base. - - - handle est un identifiant de base, retourné par - dba_open. - - - dba_firstkey retourne la clé, ou &false;, suivant - que la première clé existe ou pas. - - - Voir aussi : dba_nextkey. - - - - - - dba_insert - Insère une entrée. - - - Description - - - bool dba_insert - string key - string value - resource handle - - - - dba_insert insère l'entrée décrite - par la clé key et la valeur - value dans la base spécifiée - par handle. Si une entrée aveec la même - clé key existe déjà, l'insertion - échouera. - - - key est la clé de la valeur à - insérer. - - - value est la valeur à insérer. - - - handle est un identifiant de base, retourné par - dba_open. - - - dba_insert retourne &true; ou &false;, suivant que l'insertion - a réussi ou échoué. - - - Voir aussi : dba_exists, dba_delete, - dba_fetch et dba_replace. - - - - - - dba_nextkey - Lit la clé suivante. - - - Description - - - string dba_nextkey - resource handle - - - - dba_nextkey retourne la clé suivante, - dans la base identifiée par handle et - incrémente le pointeur de clé. - - - handle est un identifiant de base, retourné par - dba_open. - - - dba_nextkey retourne la clé, ou &false; en cas d'échec. - - - Voir aussi: dba_firstkey. - - - - - - dba_popen - Ouvre une connexion persistante à une base de données. - - - Description - - - int dba_popen - string path - string mode - string handler - ... - - - - dba_popen établit une connexion persistante - à la base repérée par path - avec le mode mode, en utilisant l'identifiant - handler. - - - path est le chemin sur votre machine. - - - mode vaut "r" pour lecture seule, "w" pour - lecture/écriture, "c" pour lecture/écriture, et - création si la base n'existe pas, et "n" pour - création, écrasement, et accès en - lecture/écriture. - - - handler est le nom de l'identifiant qui sera - utilisé pour accéder à path. - Il est passé à dba_popen. - - - dba_popen retourne un identifiant positif, - ou &false;, suivant que la base a été ouverte, ou que - l'accès a échoué. - - - Voir aussi : dba_open et dba_close. - - - - - - dba_open - Ouvre une base de données. - - - Description - - - int dba_open - string path - string mode - string handler - ... - - - - dba_open établit une connexion à - la base repérée par path avec le - mode mode et l'identifiant handler. - - - pathest le chemin sur votre machine. - - - mode vaut "r" pour lecture seule, "w" pour - lecture/écriture, "c" pour lecture/écriture, et - création si la base n'existe pas, et "n" pour - création, écrasement, et accès en - lecture/écriture. - - - handler est le nom de l'identifiant qui - sera utilisé pour accéder à path. - Il est passé à dba_popen. - - - Voir aussi : dba_popen et dba_close. - - - - - - dba_optimize - Optimise une base. - - - Description - - - bool dba_optimize - resource handle - - - - dba_optimize optimise la base de données - identifiée par handle. - - - handle est un identifiant de base retourné par - dba_open. - - - dba_optimize retourne &true; ou &false;, suivant que - l'optimisation a réussi ou échoué. - - - Voir aussi : dba_sync. - - - - - - dba_replace - Remplace ou insère une entrée. - - - Description - - - bool dba_replace - string key - string value - resource handle - - - - dba_replace remplaces ou insère une entrée, - pour la clé key et avec la valeur - value dans la base identifiée par - handle. - - - key est la clé qui va être - insérée. - - - value est la valeur qui va être - insérée. - - - handle est un identifiant de base retourné par - dba_open. - - - dba_replace retourne &true; ou &false;, suivant que - l'opération réussit ou échoue. - - - Voir aussi : dba_exists, dba_delete, - dba_fetch et dba_insert. - - - - - - dba_sync - Synchronise une base de données. - - - Description - - - bool dba_sync - resource handle - - - - dba_sync synchronise la base de données - spécifiée par handle. Si - accepté, cela va probablement lancer une opération - de réécriture physique du fichier. - - - handle est un identifiant de base retourné par - dba_open. - - - dba_sync retourne &true; ou &false;, si la - synchronisation réussi, ou échoue, respectivement. - - - Voir aussi : dba_optimize. - - - - + + +