cvs: peardoc /fr/package/database/db intro-portability.xml intro-query.xml intro-sequences.xml
| From: | Yannick TORRES | Date: | Tue, 06 Jul 2004 16:16:49 +0000 |
| Subject: | cvs: peardoc /fr/package/database/db intro-portability.xml intro-query.xml intro-sequences.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-4569@lists.php.net to get a copy of this message | ||
yannick Tue Jul 6 12:16:49 2004 EDT
Modified files:
/peardoc/fr/package/database/db intro-portability.xml
intro-query.xml intro-sequences.xml
Log:
sync with EN revision
http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-portability.xml?r1=1.4&r2=1.5&ty=u Index: peardoc/fr/package/database/db/intro-portability.xml diff -u peardoc/fr/package/database/db/intro-portability.xml:1.4 peardoc/fr/package/database/db/intro-portability.xml:1.5 --- peardoc/fr/package/database/db/intro-portability.xml:1.4 Fri Mar 5 12:57:12 2004 +++ peardoc/fr/package/database/db/intro-portability.xml Tue Jul 6 12:16:49 2004 @@ -1,86 +1,64 @@ -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.11 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.22 Maintainer: didou Status: ready --> + <refentry id="package.database.db.intro-portability"> <refnamediv> - <refname>Introduction - Portabilité</refname> - <refpurpose>Portabilité de base de données</refpurpose> + <refname>Introduction - Portabilité</refname> + <refpurpose>Portabilité de base de données</refpurpose> </refnamediv> <refsect1 id="package.database.db.intro-portability.desc"> &title.desc; <para> - Chaque système de gestion de base de données (DBMS) possède son - propre comportement. Par exemple, quelques base de données mettent + Chaque système de gestion de base de données (DBMS) possède son + propre comportement. Par exemple, quelques base de données mettent les noms des champs en majuscules lors de l'affichage, d'autres les - mettent en minuscule, d'autres encore ne font rien. Ces différences - rendent difficile le portage de scripts d'un type de serveur à un autre. - PEAR DB essaye de s'adapter au mieux pour diminuer ces différences, pour + mettent en minuscule, d'autres encore ne font rien. Ces différences + rendent difficile le portage de scripts d'un type de serveur à un autre. + PEAR DB essaye de s'adapter au mieux pour diminuer ces différences, pour que vos migrations ne soient plus un calvaire. </para> <para> - vous contrôlez le mode de portabilité à utiliser en utilisant + Vous contrôlez le mode de portabilité en utilisant l'option de configuration + <varname>portability</varname>. + Vous définissez ces options en utilisant <link linkend="package.database.db.db.connect"> - <function>connect</function></link> et + <function>connect</function></link> et <link linkend="package.database.db.db-common.setoption"> - <function>setOption</function></link>. + <function>setOption</function></link>. </para> <para> - Les modes de portabilités sont des bits, ils peuvent donc être combinés - en utilisant <literal>|</literal> et supprimés en utilisant <literal>^</literal>. + Les modes de portabilités sont des bits, ils peuvent donc être combinés + en utilisant <literal>|</literal> et supprimés en utilisant <literal>^</literal>. Regardez les exemples suivants pour comprendre. </para> </refsect1> <refsect1 id="package.database.db.intro-portability.constants"> - <title>Constantes des modes de portabilité</title> + <title>Constantes des modes de portabilité</title> <para> <itemizedlist> + <listitem> <para> - <constant>DB_PORTABILITY_NONE</constant> (défaut) - </para> - <para> - désactivé les fonctionnalités de portabilité - </para> - </listitem> - <listitem> - <para> - <constant>DB_PORTABILITY_LOWERCASE</constant> - </para> - <para> - convertit le nom des tables et des champs en minuscules lors de - l'utilisation de <function>get*</function>, <function>fetch*</function> et - <function>tableInfo</function> - </para> - </listitem> - <listitem> - <para> - <constant>DB_PORTABILITY_RTRIM</constant> + <constant>DB_PORTABILITY_ALL</constant> </para> <para> - Supprime les espaces blancs de la droite des données renvoyées par - <function>get*</function> et <function>fetch*</function> + active les fonctionnalités de portabilité </para> </listitem> + <listitem> <para> <constant>DB_PORTABILITY_DELETE_COUNT</constant> </para> <para> - force à renvoyer le nombre de lignes supprimées. - Quelques DBMS ne compte pas les lignes effacées lors de l'exécution - de requêtes simples comme <literal>DELETE FROM nomtable</literal>. - Ce mode force ces DBMS à renvoyer le nombre en question en ajoutant - <literal>WHERE 1=1</literal> à la fin de la requête <literal>DELETE</literal> - queries. - </para> - </listitem> - <listitem> - <para> - <constant>DB_PORTABILITY_NUMROWS</constant> - </para> - <para> - active un script qui fait fonctionner <function>numRows</function> avec Oracle + force à renvoyer le nombre de lignes supprimées. + Quelques DBMS ne compte pas les lignes effacées lors de l'exécution + de requêtes simples comme <userinput>DELETE FROM nomtable</userinput>. + Ce mode force ces DBMS à renvoyer le nombre en question en ajoutant + <userinput>WHERE 1=1</userinput> à la fin de la requête <command>DELETE</command>. </para> </listitem> @@ -89,7 +67,7 @@ <constant>DB_PORTABILITY_ERRORS</constant> </para> <para> - rend les messages d'erreurs de certains pilotes compatible avec les + rend les messages d'erreurs de certains pilotes compatibles avec les messages des autres serveurs </para> <para> @@ -145,8 +123,8 @@ le pilote MS ODBC fait une erreur en rapportant 'no such field' (aucun champ portant ce nom) avec le code <computeroutput>07001</computeroutput>, qui signifie - 'pas assez de paramètres.' Lorsque cette option est activée, le - code est rectifié. + 'pas assez de paramètres.' Lorsque cette option est activée, le + code est rectifié. </entry> <entry> <constant>DB_ERROR_MISMATCH</constant> @@ -165,22 +143,53 @@ <listitem> <para> + <constant>DB_PORTABILITY_LOWERCASE</constant> + </para> + <para> + convertit le nom des tables et des champs en minuscules lors de + l'utilisation de <function>get*</function>, <function>fetch*</function> et + <function>tableInfo</function> + </para> + </listitem> + + <listitem> + <para> + <constant>DB_PORTABILITY_NONE</constant> (défaut) + </para> + <para> + Désactive les fonctionnalités de portabilité + </para> + </listitem> + + <listitem> + <para> <constant>DB_PORTABILITY_NULL_TO_EMPTY</constant> </para> <para> - convertit les valeurs nulles en chaînes vides pour les fonctions get*() - et fetch*(). Cela est requis car Oracle considère les chaînes vides comme étant - null, alors que la plupart des autres pilotes font la différence entre vide et + convertit les valeurs nulles en chaînes vides pour les fonctions + <function>get*</function> et <function>fetch*</function>. + Cela est requis car Oracle considère les chaînes vides comme étant + null, alors que la plupart des autres pilotes font la différence entre vide et null. </para> </listitem> + + <listitem> + <para> + <constant>DB_PORTABILITY_NUMROWS</constant> + </para> + <para> + active un script qui fait fonctionner <function>numRows</function> avec Oracle + </para> + </listitem> <listitem> <para> - <constant>DB_PORTABILITY_ALL</constant> + <constant>DB_PORTABILITY_RTRIM</constant> </para> <para> - active toutes les fonctionnalités de portabilité + Supprime les espaces blancs de la droite des données renvoyées par + <function>get*</function> et <function>fetch*</function> </para> </listitem> @@ -189,12 +198,12 @@ </refsect1> <refsect1 id="package.database.db.intro-portability.compatibility"> - <title>Compatibilité ascendante</title> + <title>Compatibilité ascendante</title> <para> - Quelques fonctionnalités étaient supportées par l'option <literal>optimize</literal> - qui est maintenant déconseillée. Pour une compatibilité ascendante, lorsque cette - option est configurée à <literal>portability</literal>, les bases de données suivantes - ont ces modes de portabilité activés : + Quelques fonctionnalités étaient supportées par l'option <varname>optimize</varname> + qui est maintenant déconseillée. Pour une compatibilité ascendante, lorsque cette + option est configurée à <literal>portability</literal>, les bases de données suivantes + ont ces modes de portabilité activés : <itemizedlist> <listitem> <para> @@ -212,17 +221,18 @@ </itemizedlist> </para> <para> - Lorsque l'option <literal>optimize</literal> est configurée à la valeur - <literal>performance</literal>, le mode de portabilité est changé en + Lorsque l'option <varname>optimize</varname> est configurée à la valeur + <literal>performance</literal>, le mode de portabilité est changé en <constant>DB_PORTABILITY_NONE</constant>. </para> </refsect1> + <refsect1 id="package.database.db.intro-portability.example"> &title.example; <example> - <title>Activer toutes les options de portabilité lors de la connexion</title> + <title>Activer toutes les options de portabilité lors de la connexion</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php require_once 'DB.php'; @@ -234,19 +244,20 @@ $db =& DB::connect($dsn, $options); if (DB::isError($db)) { - die($db->getMessage()); + die($db->getMessage()); } ?> ]]> </programlisting> </example> + <example> <title> - Utilisation de <function>setOption</function> pour activer la portabilité - pour le passage en minuscules et le nettoyage des espaces blancs à droite + Utilisation de <function>setOption</function> pour activer la portabilité + pour le passage en minuscules et le nettoyage des espaces blancs à droite </title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // On suppose que vous avez un objet $db valide... $db->setOption('portability', @@ -255,13 +266,14 @@ ]]> </programlisting> </example> + <example> <title> Utilisation de <function>setOption</function> pour activer toutes les - options de portabilité à part le nettoyage des espaces blancs à droite + options de portabilité à part le nettoyage des espaces blancs à droite </title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // On suppose que vous avez un objet $db valide... $db->setOption('portability', http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-query.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/intro-query.xml diff -u peardoc/fr/package/database/db/intro-query.xml:1.2 peardoc/fr/package/database/db/intro-query.xml:1.3 --- peardoc/fr/package/database/db/intro-query.xml:1.2 Fri Feb 20 10:54:33 2004 +++ peardoc/fr/package/database/db/intro-query.xml Tue Jul 6 12:16:49 2004 @@ -1,86 +1,99 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.13 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.23 Maintainer: didou Status: ready --> + <refentry id="package.database.db.intro-query"> <refnamediv> - <refname>Introduction - Requête</refname> - <refpurpose>Exécuter des requêtes</refpurpose> + <refname>Introduction - Requête</refname> + <refpurpose>Exécuter des requêtes</refpurpose> </refnamediv> + <refsect1 id="package.database.db.intro-query.desc"> &title.desc; - <simpara> - Pour exécuter une requête sur une base de données, vous devez utiliser - la fonction <link linkend="package.database.db.db-common.query"> - <function>query</function></link>, qui prend en paramètre la requête. - En cas d'erreurs, vous obtiendrez un objet <link - linkend="package.database.db.db-error">&class.db-error;</link>, - vérifiez le avec <link linkend="package.database.db.db.iserror"> - <function>DB::isError</function></link>. En cas de succès, vous obtiendrez - en retour &constant.db-ok; ou un objet <link linkend="package.database.db.db-result"> - &class.db-result;</link> si vous avez exécuté une requête de type SELECT. - </simpara> + <para> + PEAR DB fournit plusieurs méthodes pour interroger les bases de données. + La méthode la plus directe est + <link linkend="package.database.db.db-common.query"> + <function>query</function></link>. + Il prend en tant que paramètre la requête. + Il y a trois retours possibles : + un nouvel objet &class.db-result; pour les requêtes qui retournent + des résultats (comme les requêtes <command>SELECT</command>), + &constant.db-ok; pour les requêtes qui manipulent des données + (comme les requêtes <command>INSERT</command>) ou un objet + &class.db-error; en cas d'erreur. + </para> + <example> - <title>Exécuter une requête</title> + <title>Exécuter une requête</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php -// On suppose que vous avez un objet $db valide... -$sql = "select * from clients"; +// Création d'un objet DB valide nommé $db +// en début de votre programme... +require_once 'DB.php'; + +$db =& DB::connect('pgsql://usr:pw@localhost/dbnam'); +if (DB::isError($db)) { + die($db->getMessage()); +} -$result =& $db->query($sql); +// Exécution de la requête +$res =& $db->query('SELECT * FROM clients'); -// Vérifiez toujours que $result n'est pas une erreur -if (DB::isError($result)) { - die ($result->getMessage()); +// Vérifiez toujours que $res n'est pas une erreur +if (DB::isError($res)) { + die($res->getMessage()); } -.... ?> ]]> </programlisting> </example> + <para> - <function>query</function> peut être utilisée à la place de + <function>query</function> peut être utilisée à la place de <link linkend="package.database.db.db-common.prepare"> <function>prepare</function></link> et <link linkend="package.database.db.db-common.execute"> - <function>execute</function></link>, si vous utilisez le paramètre - <parameter>$params</parameter> et que vous posisionnez vos marqueurs. + <function>execute</function></link>, si vous utilisez le paramètre + <parameter>$params</parameter> et que vous posissionnez vos marqueurs. </para> + <example> - <title>Utiliser une requête en mode prepare/execute avec un paramètre scalaire</title> + <title>Utiliser une requête en mode prepare/execute avec un paramètre scalaire</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // On suppose que vous avez un objet $db valide... $sql = 'select * from clients where clientid = ?'; $data = 53; -$result =& $db->query($sql, $data); +$res =& $db->query($sql, $data); -// Vérifiez toujours que $result n'est pas une erreur -if (DB::isError($result)) { - die ($result->getMessage()); +// Vérifiez toujours que $res n'est pas une erreur +if (DB::isError($res)) { + die($res->getMessage()); } -.... ?> ]]> </programlisting> </example> + <example> - <title>Utiliser une requête en mode prepare/execute avec un tableau en paramètre</title> + <title>Utiliser une requête en mode prepare/execute avec un tableau en paramètre</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // On suppose que vous avez un objet $db valide... $sql = 'select * from clients where clientid = ? and statusid = ?'; $data = array(53, 4); -$result =& $db->query($sql, $data); +$res =& $db->query($sql, $data); -// Vérifiez toujours que $result n'est pas une erreur -if (DB::isError($result)) { - die ($result->getMessage()); +// Vérifiez toujours que $res n'est pas une erreur +if (DB::isError($res)) { + die ($res->getMessage()); } -.... ?> ]]> </programlisting> http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-sequences.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/fr/package/database/db/intro-sequences.xml diff -u peardoc/fr/package/database/db/intro-sequences.xml:1.3 peardoc/fr/package/database/db/intro-sequences.xml:1.4 --- peardoc/fr/package/database/db/intro-sequences.xml:1.3 Sat Feb 21 21:56:26 2004 +++ peardoc/fr/package/database/db/intro-sequences.xml Tue Jul 6 12:16:49 2004 @@ -1,77 +1,84 @@ -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.12 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.18 Maintainer: didou Status: ready --> + <refentry id="package.database.db.intro-sequences"> - <refnamediv> - <refname>Introduction - Séquences</refname> - <refpurpose>Séquences et auto-incrémentation</refpurpose> - </refnamediv> - <refsect1 id="package.database.db.intro-sequences.desc"> - &title.desc; - <para> - Les séquences sont une façon d'offrir des identifiants - uniques pour les enregistrements. Si vous travaillez principalement - avec MySQL, pensez que les séquences sont une autre façon - de réaliser la tâche d'<constant>AUTO_INCREMENT</constant>. - </para> - <para> - C'est relativement simple, d'abord vous demandez un identifiant et vous - insérez sa valeur dans le champ ID du nouvel enregistrement que vous - créez. Vous pouvez avoir plus d'une séquence pour toutes vos - tables, soyez juste sûrs de toujours utiliser la même - séquence pour une table donnée. Pour obtenir la valeur de - l'identifiant unique utilisez <link - linkend="package.database.db.db-common.nextid"><function>nextId</function></link>, - si une séquence n'existe pas elle sera créée automatiquement. - <example> - <title>Utiliser une séquence</title> - <programlisting role="php"> - <![CDATA[ + <refnamediv> + <refname>Introduction - Séquences</refname> + <refpurpose>Séquences et auto-incrémentation</refpurpose> + </refnamediv> + + <refsect1 id="package.database.db.intro-sequences.desc"> + &title.desc; + <para> + Les séquences sont une façon d'offrir des identifiants + uniques pour les enregistrements. Si vous travaillez principalement + avec MySQL, pensez que les séquences sont une autre façon + de réaliser la tâche d'<command>AUTO_INCREMENT</command>. + </para> + + <para> + C'est relativement simple, d'abord vous demandez un identifiant et vous + insérez sa valeur dans le champ ID du nouvel enregistrement que vous + créez. Vous pouvez avoir plus d'une séquence pour toutes vos + tables, soyez juste sûrs de toujours utiliser la même + séquence pour une table donnée. Pour obtenir la valeur de + l'identifiant unique utilisez <link + linkend="package.database.db.db-common.nextid"><function>nextId</function></link>, + si une séquence n'existe pas elle sera créée automatiquement. + + <example> + <title>Utiliser une séquence</title> + <programlisting role="php"> +<![CDATA[ <?php -// On suppose que vous avec un objet DB valide nommé $db +// On suppose que vous avec un objet DB valide nommé $db $id = $db->nextId('mySequence'); +if (DB::isError($id)) { + die($id->getMessage()); +} -// Utilisez l'identifiant dans votre requête -$res =& $db->query("INSERT INTO myTable (id,text) VALUES ($id,'foo')"); +// Utilisez l'identifiant dans votre requête +$res =& $db->query("INSERT INTO myTable (id, text) VALUES ($id, 'foo')"); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - - <refsect1 id="package.database.db.intro-sequences.note"> - &title.note; - <para> - Si vous avez besoin d'accéder manuellement aux objets base de données - que PEAR DB utilise pour stocker les informations d'une séquence, sachez - que les objets sont nommés en passant l'argument <parameter>$seq_name</parameter> - que vous fournissez aux méthode de séquences PEAR DB via la fonction - PHP <function>sprintf</function> en utilisant la valeur de l'option - <varname>seqname_format</varname> en tant qu'argument de format de - <function>sprintf</function>. - </para> - <para> - Le <varname>seqname_format</varname> par défaut est <literal>%s_seq</literal>, - qui peut être changé lors de la connexion avec - <link linkend="package.database.db.db.connect"> - <function>connect</function></link> ou via - <link linkend="package.database.db.db-common.setoption"> - <function>setOption</function></link>. - </para> - </refsect1> + </programlisting> + </example> + </para> + </refsect1> - <refsect1 id="package.database.db.intro-sequences.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.createsequence"> - <function>createSequence</function></link>, - <link linkend="package.database.db.db-common.nextid"> - <function>nextId</function></link>, - <link linkend="package.database.db.db-common.dropsequence"> - <function>dropSequence</function></link> - </para> - </refsect1> + <refsect1 id="package.database.db.intro-sequences.note"> + &title.note; + <para> + Si vous avez besoin d'accéder manuellement aux objets base de données + que PEAR DB utilise pour stocker les informations d'une séquence, sachez + que les objets sont nommés en passant l'argument <parameter>$seq_name</parameter> + que vous fournissez aux méthode de séquences PEAR DB via la fonction + PHP <function>sprintf</function> en utilisant la valeur de l'option + <varname>seqname_format</varname> en tant qu'argument de format de + <function>sprintf</function>. + </para> + <para> + Le <varname>seqname_format</varname> par défaut est <literal>%s_seq</literal>, + qui peut être changé lors de la connexion avec + <link linkend="package.database.db.db.connect"> + <function>connect</function></link> ou via + <link linkend="package.database.db.db-common.setoption"> + <function>setOption</function></link>. + </para> + </refsect1> + <refsect1 id="package.database.db.intro-sequences.see"> + &title.see; + <para> + <link linkend="package.database.db.db-common.createsequence"> + <function>createSequence</function></link>, + <link linkend="package.database.db.db-common.nextid"> + <function>nextId</function></link>, + <link linkend="package.database.db.db-common.dropsequence"> + <function>dropSequence</function></link> + </para> + </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-portability.xml?r1=1.4&r2=1.5&ty=u Index: peardoc/fr/package/database/db/intro-portability.xml diff -u peardoc/fr/package/database/db/intro-portability.xml:1.4 peardoc/fr/package/database/db/intro-portability.xml:1.5 --- peardoc/fr/package/database/db/intro-portability.xml:1.4 Fri Mar 5 12:57:12 2004 +++ peardoc/fr/package/database/db/intro-portability.xml Tue Jul 6 12:16:49 2004 @@ -1,86 +1,64 @@ -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.11 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.22 Maintainer: didou Status: ready --> + <refentry id="package.database.db.intro-portability"> <refnamediv> - <refname>Introduction - Portabilité</refname> - <refpurpose>Portabilité de base de données</refpurpose> + <refname>Introduction - Portabilité</refname> + <refpurpose>Portabilité de base de données</refpurpose> </refnamediv> <refsect1 id="package.database.db.intro-portability.desc"> &title.desc; <para> - Chaque système de gestion de base de données (DBMS) possède son - propre comportement. Par exemple, quelques base de données mettent + Chaque système de gestion de base de données (DBMS) possède son + propre comportement. Par exemple, quelques base de données mettent les noms des champs en majuscules lors de l'affichage, d'autres les - mettent en minuscule, d'autres encore ne font rien. Ces différences - rendent difficile le portage de scripts d'un type de serveur à un autre. - PEAR DB essaye de s'adapter au mieux pour diminuer ces différences, pour + mettent en minuscule, d'autres encore ne font rien. Ces différences + rendent difficile le portage de scripts d'un type de serveur à un autre. + PEAR DB essaye de s'adapter au mieux pour diminuer ces différences, pour que vos migrations ne soient plus un calvaire. </para> <para> - vous contrôlez le mode de portabilité à utiliser en utilisant + Vous contrôlez le mode de portabilité en utilisant l'option de configuration + <varname>portability</varname>. + Vous définissez ces options en utilisant <link linkend="package.database.db.db.connect"> - <function>connect</function></link> et + <function>connect</function></link> et <link linkend="package.database.db.db-common.setoption"> - <function>setOption</function></link>. + <function>setOption</function></link>. </para> <para> - Les modes de portabilités sont des bits, ils peuvent donc être combinés - en utilisant <literal>|</literal> et supprimés en utilisant <literal>^</literal>. + Les modes de portabilités sont des bits, ils peuvent donc être combinés + en utilisant <literal>|</literal> et supprimés en utilisant <literal>^</literal>. Regardez les exemples suivants pour comprendre. </para> </refsect1> <refsect1 id="package.database.db.intro-portability.constants"> - <title>Constantes des modes de portabilité</title> + <title>Constantes des modes de portabilité</title> <para> <itemizedlist> + <listitem> <para> - <constant>DB_PORTABILITY_NONE</constant> (défaut) - </para> - <para> - désactivé les fonctionnalités de portabilité - </para> - </listitem> - <listitem> - <para> - <constant>DB_PORTABILITY_LOWERCASE</constant> - </para> - <para> - convertit le nom des tables et des champs en minuscules lors de - l'utilisation de <function>get*</function>, <function>fetch*</function> et - <function>tableInfo</function> - </para> - </listitem> - <listitem> - <para> - <constant>DB_PORTABILITY_RTRIM</constant> + <constant>DB_PORTABILITY_ALL</constant> </para> <para> - Supprime les espaces blancs de la droite des données renvoyées par - <function>get*</function> et <function>fetch*</function> + active les fonctionnalités de portabilité </para> </listitem> + <listitem> <para> <constant>DB_PORTABILITY_DELETE_COUNT</constant> </para> <para> - force à renvoyer le nombre de lignes supprimées. - Quelques DBMS ne compte pas les lignes effacées lors de l'exécution - de requêtes simples comme <literal>DELETE FROM nomtable</literal>. - Ce mode force ces DBMS à renvoyer le nombre en question en ajoutant - <literal>WHERE 1=1</literal> à la fin de la requête <literal>DELETE</literal> - queries. - </para> - </listitem> - <listitem> - <para> - <constant>DB_PORTABILITY_NUMROWS</constant> - </para> - <para> - active un script qui fait fonctionner <function>numRows</function> avec Oracle + force à renvoyer le nombre de lignes supprimées. + Quelques DBMS ne compte pas les lignes effacées lors de l'exécution + de requêtes simples comme <userinput>DELETE FROM nomtable</userinput>. + Ce mode force ces DBMS à renvoyer le nombre en question en ajoutant + <userinput>WHERE 1=1</userinput> à la fin de la requête <command>DELETE</command>. </para> </listitem> @@ -89,7 +67,7 @@ <constant>DB_PORTABILITY_ERRORS</constant> </para> <para> - rend les messages d'erreurs de certains pilotes compatible avec les + rend les messages d'erreurs de certains pilotes compatibles avec les messages des autres serveurs </para> <para> @@ -145,8 +123,8 @@ le pilote MS ODBC fait une erreur en rapportant 'no such field' (aucun champ portant ce nom) avec le code <computeroutput>07001</computeroutput>, qui signifie - 'pas assez de paramètres.' Lorsque cette option est activée, le - code est rectifié. + 'pas assez de paramètres.' Lorsque cette option est activée, le + code est rectifié. </entry> <entry> <constant>DB_ERROR_MISMATCH</constant> @@ -165,22 +143,53 @@ <listitem> <para> + <constant>DB_PORTABILITY_LOWERCASE</constant> + </para> + <para> + convertit le nom des tables et des champs en minuscules lors de + l'utilisation de <function>get*</function>, <function>fetch*</function> et + <function>tableInfo</function> + </para> + </listitem> + + <listitem> + <para> + <constant>DB_PORTABILITY_NONE</constant> (défaut) + </para> + <para> + Désactive les fonctionnalités de portabilité + </para> + </listitem> + + <listitem> + <para> <constant>DB_PORTABILITY_NULL_TO_EMPTY</constant> </para> <para> - convertit les valeurs nulles en chaînes vides pour les fonctions get*() - et fetch*(). Cela est requis car Oracle considère les chaînes vides comme étant - null, alors que la plupart des autres pilotes font la différence entre vide et + convertit les valeurs nulles en chaînes vides pour les fonctions + <function>get*</function> et <function>fetch*</function>. + Cela est requis car Oracle considère les chaînes vides comme étant + null, alors que la plupart des autres pilotes font la différence entre vide et null. </para> </listitem> + + <listitem> + <para> + <constant>DB_PORTABILITY_NUMROWS</constant> + </para> + <para> + active un script qui fait fonctionner <function>numRows</function> avec Oracle + </para> + </listitem> <listitem> <para> - <constant>DB_PORTABILITY_ALL</constant> + <constant>DB_PORTABILITY_RTRIM</constant> </para> <para> - active toutes les fonctionnalités de portabilité + Supprime les espaces blancs de la droite des données renvoyées par + <function>get*</function> et <function>fetch*</function> </para> </listitem> @@ -189,12 +198,12 @@ </refsect1> <refsect1 id="package.database.db.intro-portability.compatibility"> - <title>Compatibilité ascendante</title> + <title>Compatibilité ascendante</title> <para> - Quelques fonctionnalités étaient supportées par l'option <literal>optimize</literal> - qui est maintenant déconseillée. Pour une compatibilité ascendante, lorsque cette - option est configurée à <literal>portability</literal>, les bases de données suivantes - ont ces modes de portabilité activés : + Quelques fonctionnalités étaient supportées par l'option <varname>optimize</varname> + qui est maintenant déconseillée. Pour une compatibilité ascendante, lorsque cette + option est configurée à <literal>portability</literal>, les bases de données suivantes + ont ces modes de portabilité activés : <itemizedlist> <listitem> <para> @@ -212,17 +221,18 @@ </itemizedlist> </para> <para> - Lorsque l'option <literal>optimize</literal> est configurée à la valeur - <literal>performance</literal>, le mode de portabilité est changé en + Lorsque l'option <varname>optimize</varname> est configurée à la valeur + <literal>performance</literal>, le mode de portabilité est changé en <constant>DB_PORTABILITY_NONE</constant>. </para> </refsect1> + <refsect1 id="package.database.db.intro-portability.example"> &title.example; <example> - <title>Activer toutes les options de portabilité lors de la connexion</title> + <title>Activer toutes les options de portabilité lors de la connexion</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php require_once 'DB.php'; @@ -234,19 +244,20 @@ $db =& DB::connect($dsn, $options); if (DB::isError($db)) { - die($db->getMessage()); + die($db->getMessage()); } ?> ]]> </programlisting> </example> + <example> <title> - Utilisation de <function>setOption</function> pour activer la portabilité - pour le passage en minuscules et le nettoyage des espaces blancs à droite + Utilisation de <function>setOption</function> pour activer la portabilité + pour le passage en minuscules et le nettoyage des espaces blancs à droite </title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // On suppose que vous avez un objet $db valide... $db->setOption('portability', @@ -255,13 +266,14 @@ ]]> </programlisting> </example> + <example> <title> Utilisation de <function>setOption</function> pour activer toutes les - options de portabilité à part le nettoyage des espaces blancs à droite + options de portabilité à part le nettoyage des espaces blancs à droite </title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // On suppose que vous avez un objet $db valide... $db->setOption('portability', http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-query.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/intro-query.xml diff -u peardoc/fr/package/database/db/intro-query.xml:1.2 peardoc/fr/package/database/db/intro-query.xml:1.3 --- peardoc/fr/package/database/db/intro-query.xml:1.2 Fri Feb 20 10:54:33 2004 +++ peardoc/fr/package/database/db/intro-query.xml Tue Jul 6 12:16:49 2004 @@ -1,86 +1,99 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.13 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.23 Maintainer: didou Status: ready --> + <refentry id="package.database.db.intro-query"> <refnamediv> - <refname>Introduction - Requête</refname> - <refpurpose>Exécuter des requêtes</refpurpose> + <refname>Introduction - Requête</refname> + <refpurpose>Exécuter des requêtes</refpurpose> </refnamediv> + <refsect1 id="package.database.db.intro-query.desc"> &title.desc; - <simpara> - Pour exécuter une requête sur une base de données, vous devez utiliser - la fonction <link linkend="package.database.db.db-common.query"> - <function>query</function></link>, qui prend en paramètre la requête. - En cas d'erreurs, vous obtiendrez un objet <link - linkend="package.database.db.db-error">&class.db-error;</link>, - vérifiez le avec <link linkend="package.database.db.db.iserror"> - <function>DB::isError</function></link>. En cas de succès, vous obtiendrez - en retour &constant.db-ok; ou un objet <link linkend="package.database.db.db-result"> - &class.db-result;</link> si vous avez exécuté une requête de type SELECT. - </simpara> + <para> + PEAR DB fournit plusieurs méthodes pour interroger les bases de données. + La méthode la plus directe est + <link linkend="package.database.db.db-common.query"> + <function>query</function></link>. + Il prend en tant que paramètre la requête. + Il y a trois retours possibles : + un nouvel objet &class.db-result; pour les requêtes qui retournent + des résultats (comme les requêtes <command>SELECT</command>), + &constant.db-ok; pour les requêtes qui manipulent des données + (comme les requêtes <command>INSERT</command>) ou un objet + &class.db-error; en cas d'erreur. + </para> + <example> - <title>Exécuter une requête</title> + <title>Exécuter une requête</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php -// On suppose que vous avez un objet $db valide... -$sql = "select * from clients"; +// Création d'un objet DB valide nommé $db +// en début de votre programme... +require_once 'DB.php'; + +$db =& DB::connect('pgsql://usr:pw@localhost/dbnam'); +if (DB::isError($db)) { + die($db->getMessage()); +} -$result =& $db->query($sql); +// Exécution de la requête +$res =& $db->query('SELECT * FROM clients'); -// Vérifiez toujours que $result n'est pas une erreur -if (DB::isError($result)) { - die ($result->getMessage()); +// Vérifiez toujours que $res n'est pas une erreur +if (DB::isError($res)) { + die($res->getMessage()); } -.... ?> ]]> </programlisting> </example> + <para> - <function>query</function> peut être utilisée à la place de + <function>query</function> peut être utilisée à la place de <link linkend="package.database.db.db-common.prepare"> <function>prepare</function></link> et <link linkend="package.database.db.db-common.execute"> - <function>execute</function></link>, si vous utilisez le paramètre - <parameter>$params</parameter> et que vous posisionnez vos marqueurs. + <function>execute</function></link>, si vous utilisez le paramètre + <parameter>$params</parameter> et que vous posissionnez vos marqueurs. </para> + <example> - <title>Utiliser une requête en mode prepare/execute avec un paramètre scalaire</title> + <title>Utiliser une requête en mode prepare/execute avec un paramètre scalaire</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // On suppose que vous avez un objet $db valide... $sql = 'select * from clients where clientid = ?'; $data = 53; -$result =& $db->query($sql, $data); +$res =& $db->query($sql, $data); -// Vérifiez toujours que $result n'est pas une erreur -if (DB::isError($result)) { - die ($result->getMessage()); +// Vérifiez toujours que $res n'est pas une erreur +if (DB::isError($res)) { + die($res->getMessage()); } -.... ?> ]]> </programlisting> </example> + <example> - <title>Utiliser une requête en mode prepare/execute avec un tableau en paramètre</title> + <title>Utiliser une requête en mode prepare/execute avec un tableau en paramètre</title> <programlisting role="php"> - <![CDATA[ +<![CDATA[ <?php // On suppose que vous avez un objet $db valide... $sql = 'select * from clients where clientid = ? and statusid = ?'; $data = array(53, 4); -$result =& $db->query($sql, $data); +$res =& $db->query($sql, $data); -// Vérifiez toujours que $result n'est pas une erreur -if (DB::isError($result)) { - die ($result->getMessage()); +// Vérifiez toujours que $res n'est pas une erreur +if (DB::isError($res)) { + die ($res->getMessage()); } -.... ?> ]]> </programlisting> http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-sequences.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/fr/package/database/db/intro-sequences.xml diff -u peardoc/fr/package/database/db/intro-sequences.xml:1.3 peardoc/fr/package/database/db/intro-sequences.xml:1.4 --- peardoc/fr/package/database/db/intro-sequences.xml:1.3 Sat Feb 21 21:56:26 2004 +++ peardoc/fr/package/database/db/intro-sequences.xml Tue Jul 6 12:16:49 2004 @@ -1,77 +1,84 @@ -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.12 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.18 Maintainer: didou Status: ready --> + <refentry id="package.database.db.intro-sequences"> - <refnamediv> - <refname>Introduction - Séquences</refname> - <refpurpose>Séquences et auto-incrémentation</refpurpose> - </refnamediv> - <refsect1 id="package.database.db.intro-sequences.desc"> - &title.desc; - <para> - Les séquences sont une façon d'offrir des identifiants - uniques pour les enregistrements. Si vous travaillez principalement - avec MySQL, pensez que les séquences sont une autre façon - de réaliser la tâche d'<constant>AUTO_INCREMENT</constant>. - </para> - <para> - C'est relativement simple, d'abord vous demandez un identifiant et vous - insérez sa valeur dans le champ ID du nouvel enregistrement que vous - créez. Vous pouvez avoir plus d'une séquence pour toutes vos - tables, soyez juste sûrs de toujours utiliser la même - séquence pour une table donnée. Pour obtenir la valeur de - l'identifiant unique utilisez <link - linkend="package.database.db.db-common.nextid"><function>nextId</function></link>, - si une séquence n'existe pas elle sera créée automatiquement. - <example> - <title>Utiliser une séquence</title> - <programlisting role="php"> - <![CDATA[ + <refnamediv> + <refname>Introduction - Séquences</refname> + <refpurpose>Séquences et auto-incrémentation</refpurpose> + </refnamediv> + + <refsect1 id="package.database.db.intro-sequences.desc"> + &title.desc; + <para> + Les séquences sont une façon d'offrir des identifiants + uniques pour les enregistrements. Si vous travaillez principalement + avec MySQL, pensez que les séquences sont une autre façon + de réaliser la tâche d'<command>AUTO_INCREMENT</command>. + </para> + + <para> + C'est relativement simple, d'abord vous demandez un identifiant et vous + insérez sa valeur dans le champ ID du nouvel enregistrement que vous + créez. Vous pouvez avoir plus d'une séquence pour toutes vos + tables, soyez juste sûrs de toujours utiliser la même + séquence pour une table donnée. Pour obtenir la valeur de + l'identifiant unique utilisez <link + linkend="package.database.db.db-common.nextid"><function>nextId</function></link>, + si une séquence n'existe pas elle sera créée automatiquement. + + <example> + <title>Utiliser une séquence</title> + <programlisting role="php"> +<![CDATA[ <?php -// On suppose que vous avec un objet DB valide nommé $db +// On suppose que vous avec un objet DB valide nommé $db $id = $db->nextId('mySequence'); +if (DB::isError($id)) { + die($id->getMessage()); +} -// Utilisez l'identifiant dans votre requête -$res =& $db->query("INSERT INTO myTable (id,text) VALUES ($id,'foo')"); +// Utilisez l'identifiant dans votre requête +$res =& $db->query("INSERT INTO myTable (id, text) VALUES ($id, 'foo')"); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - - <refsect1 id="package.database.db.intro-sequences.note"> - &title.note; - <para> - Si vous avez besoin d'accéder manuellement aux objets base de données - que PEAR DB utilise pour stocker les informations d'une séquence, sachez - que les objets sont nommés en passant l'argument <parameter>$seq_name</parameter> - que vous fournissez aux méthode de séquences PEAR DB via la fonction - PHP <function>sprintf</function> en utilisant la valeur de l'option - <varname>seqname_format</varname> en tant qu'argument de format de - <function>sprintf</function>. - </para> - <para> - Le <varname>seqname_format</varname> par défaut est <literal>%s_seq</literal>, - qui peut être changé lors de la connexion avec - <link linkend="package.database.db.db.connect"> - <function>connect</function></link> ou via - <link linkend="package.database.db.db-common.setoption"> - <function>setOption</function></link>. - </para> - </refsect1> + </programlisting> + </example> + </para> + </refsect1> - <refsect1 id="package.database.db.intro-sequences.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.createsequence"> - <function>createSequence</function></link>, - <link linkend="package.database.db.db-common.nextid"> - <function>nextId</function></link>, - <link linkend="package.database.db.db-common.dropsequence"> - <function>dropSequence</function></link> - </para> - </refsect1> + <refsect1 id="package.database.db.intro-sequences.note"> + &title.note; + <para> + Si vous avez besoin d'accéder manuellement aux objets base de données + que PEAR DB utilise pour stocker les informations d'une séquence, sachez + que les objets sont nommés en passant l'argument <parameter>$seq_name</parameter> + que vous fournissez aux méthode de séquences PEAR DB via la fonction + PHP <function>sprintf</function> en utilisant la valeur de l'option + <varname>seqname_format</varname> en tant qu'argument de format de + <function>sprintf</function>. + </para> + <para> + Le <varname>seqname_format</varname> par défaut est <literal>%s_seq</literal>, + qui peut être changé lors de la connexion avec + <link linkend="package.database.db.db.connect"> + <function>connect</function></link> ou via + <link linkend="package.database.db.db-common.setoption"> + <function>setOption</function></link>. + </para> + </refsect1> + <refsect1 id="package.database.db.intro-sequences.see"> + &title.see; + <para> + <link linkend="package.database.db.db-common.createsequence"> + <function>createSequence</function></link>, + <link linkend="package.database.db.db-common.nextid"> + <function>nextId</function></link>, + <link linkend="package.database.db.db-common.dropsequence"> + <function>dropSequence</function></link> + </para> + </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: