cvs: peardoc /fr/package/database/db intro-portability.xml intro-query.xml intro-sequences.xml
| From: | Yannick TORRES | Date: | Tue, 06 Jul 2004 16:18: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-4570@lists.php.net to get a copy of this message | ||
yannick Tue Jul 6 12:18:49 2004 EDT
Modified files:
/peardoc/fr/package/database/db intro-portability.xml
intro-query.xml intro-sequences.xml
Log:
oops, HTML encoded
http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-portability.xml?r1=1.5&r2=1.6&ty=u Index: peardoc/fr/package/database/db/intro-portability.xml diff -u peardoc/fr/package/database/db/intro-portability.xml:1.5 peardoc/fr/package/database/db/intro-portability.xml:1.6 --- peardoc/fr/package/database/db/intro-portability.xml:1.5 Tue Jul 6 12:16:49 2004 +++ peardoc/fr/package/database/db/intro-portability.xml Tue Jul 6 12:18:49 2004 @@ -1,42 +1,42 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- 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é en utilisant l'option de configuration + Vous contrôlez le mode de portabilité en utilisant l'option de configuration <varname>portability</varname>. - Vous définissez ces options en utilisant + Vous définissez ces options en utilisant <link linkend="package.database.db.db.connect"> <function>connect</function></link> et <link linkend="package.database.db.db-common.setoption"> <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> @@ -45,7 +45,7 @@ <constant>DB_PORTABILITY_ALL</constant> </para> <para> - active les fonctionnalités de portabilité + active les fonctionnalités de portabilité </para> </listitem> @@ -54,11 +54,11 @@ <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 <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>. + 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> @@ -123,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> @@ -154,10 +154,10 @@ <listitem> <para> - <constant>DB_PORTABILITY_NONE</constant> (défaut) + <constant>DB_PORTABILITY_NONE</constant> (défaut) </para> <para> - Désactive les fonctionnalités de portabilité + Désactive les fonctionnalités de portabilité </para> </listitem> @@ -166,10 +166,10 @@ <constant>DB_PORTABILITY_NULL_TO_EMPTY</constant> </para> <para> - convertit les valeurs nulles en chaînes vides pour les fonctions + 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 + 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> @@ -188,7 +188,7 @@ <constant>DB_PORTABILITY_RTRIM</constant> </para> <para> - Supprime les espaces blancs de la droite des données renvoyées par + Supprime les espaces blancs de la droite des données renvoyées par <function>get*</function> et <function>fetch*</function> </para> </listitem> @@ -198,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 <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 : + 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> @@ -221,8 +221,8 @@ </itemizedlist> </para> <para> - Lorsque l'option <varname>optimize</varname> 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> @@ -230,7 +230,7 @@ <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[ <?php @@ -253,8 +253,8 @@ <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[ @@ -270,7 +270,7 @@ <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[ http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-query.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/fr/package/database/db/intro-query.xml diff -u peardoc/fr/package/database/db/intro-query.xml:1.3 peardoc/fr/package/database/db/intro-query.xml:1.4 --- peardoc/fr/package/database/db/intro-query.xml:1.3 Tue Jul 6 12:16:49 2004 +++ peardoc/fr/package/database/db/intro-query.xml Tue Jul 6 12:18:49 2004 @@ -1,36 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- 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; <para> - PEAR DB fournit plusieurs méthodes pour interroger les bases de données. - La méthode la plus directe est + 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 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 + 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[ <?php -// Création d'un objet DB valide nommé $db -// en début de votre programme... +// 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'); @@ -38,10 +38,10 @@ die($db->getMessage()); } -// Exécution de la requête +// Exécution de la requête $res =& $db->query('SELECT * FROM clients'); -// Vérifiez toujours que $res n'est pas une erreur +// Vérifiez toujours que $res n'est pas une erreur if (DB::isError($res)) { die($res->getMessage()); } @@ -51,16 +51,16 @@ </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 + <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[ <?php @@ -70,7 +70,7 @@ $res =& $db->query($sql, $data); -// Vérifiez toujours que $res n'est pas une erreur +// Vérifiez toujours que $res n'est pas une erreur if (DB::isError($res)) { die($res->getMessage()); } @@ -80,7 +80,7 @@ </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[ <?php @@ -90,7 +90,7 @@ $res =& $db->query($sql, $data); -// Vérifiez toujours que $res n'est pas une erreur +// Vérifiez toujours que $res n'est pas une erreur if (DB::isError($res)) { die ($res->getMessage()); } http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-sequences.xml?r1=1.4&r2=1.5&ty=u Index: peardoc/fr/package/database/db/intro-sequences.xml diff -u peardoc/fr/package/database/db/intro-sequences.xml:1.4 peardoc/fr/package/database/db/intro-sequences.xml:1.5 --- peardoc/fr/package/database/db/intro-sequences.xml:1.4 Tue Jul 6 12:16:49 2004 +++ peardoc/fr/package/database/db/intro-sequences.xml Tue Jul 6 12:18:49 2004 @@ -1,44 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- 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> + <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 + 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>. + 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 + 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. + si une séquence n'existe pas elle sera créée automatiquement. <example> - <title>Utiliser une séquence</title> + <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 +// Utilisez l'identifiant dans votre requête $res =& $db->query("INSERT INTO myTable (id, text) VALUES ($id, 'foo')"); ?> ]]> @@ -50,17 +50,17 @@ <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 + 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 + 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">
http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-portability.xml?r1=1.5&r2=1.6&ty=u Index: peardoc/fr/package/database/db/intro-portability.xml diff -u peardoc/fr/package/database/db/intro-portability.xml:1.5 peardoc/fr/package/database/db/intro-portability.xml:1.6 --- peardoc/fr/package/database/db/intro-portability.xml:1.5 Tue Jul 6 12:16:49 2004 +++ peardoc/fr/package/database/db/intro-portability.xml Tue Jul 6 12:18:49 2004 @@ -1,42 +1,42 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- 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é en utilisant l'option de configuration + Vous contrôlez le mode de portabilité en utilisant l'option de configuration <varname>portability</varname>. - Vous définissez ces options en utilisant + Vous définissez ces options en utilisant <link linkend="package.database.db.db.connect"> <function>connect</function></link> et <link linkend="package.database.db.db-common.setoption"> <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> @@ -45,7 +45,7 @@ <constant>DB_PORTABILITY_ALL</constant> </para> <para> - active les fonctionnalités de portabilité + active les fonctionnalités de portabilité </para> </listitem> @@ -54,11 +54,11 @@ <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 <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>. + 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> @@ -123,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> @@ -154,10 +154,10 @@ <listitem> <para> - <constant>DB_PORTABILITY_NONE</constant> (défaut) + <constant>DB_PORTABILITY_NONE</constant> (défaut) </para> <para> - Désactive les fonctionnalités de portabilité + Désactive les fonctionnalités de portabilité </para> </listitem> @@ -166,10 +166,10 @@ <constant>DB_PORTABILITY_NULL_TO_EMPTY</constant> </para> <para> - convertit les valeurs nulles en chaînes vides pour les fonctions + 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 + 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> @@ -188,7 +188,7 @@ <constant>DB_PORTABILITY_RTRIM</constant> </para> <para> - Supprime les espaces blancs de la droite des données renvoyées par + Supprime les espaces blancs de la droite des données renvoyées par <function>get*</function> et <function>fetch*</function> </para> </listitem> @@ -198,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 <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 : + 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> @@ -221,8 +221,8 @@ </itemizedlist> </para> <para> - Lorsque l'option <varname>optimize</varname> 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> @@ -230,7 +230,7 @@ <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[ <?php @@ -253,8 +253,8 @@ <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[ @@ -270,7 +270,7 @@ <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[ http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-query.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/fr/package/database/db/intro-query.xml diff -u peardoc/fr/package/database/db/intro-query.xml:1.3 peardoc/fr/package/database/db/intro-query.xml:1.4 --- peardoc/fr/package/database/db/intro-query.xml:1.3 Tue Jul 6 12:16:49 2004 +++ peardoc/fr/package/database/db/intro-query.xml Tue Jul 6 12:18:49 2004 @@ -1,36 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- 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; <para> - PEAR DB fournit plusieurs méthodes pour interroger les bases de données. - La méthode la plus directe est + 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 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 + 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[ <?php -// Création d'un objet DB valide nommé $db -// en début de votre programme... +// 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'); @@ -38,10 +38,10 @@ die($db->getMessage()); } -// Exécution de la requête +// Exécution de la requête $res =& $db->query('SELECT * FROM clients'); -// Vérifiez toujours que $res n'est pas une erreur +// Vérifiez toujours que $res n'est pas une erreur if (DB::isError($res)) { die($res->getMessage()); } @@ -51,16 +51,16 @@ </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 + <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[ <?php @@ -70,7 +70,7 @@ $res =& $db->query($sql, $data); -// Vérifiez toujours que $res n'est pas une erreur +// Vérifiez toujours que $res n'est pas une erreur if (DB::isError($res)) { die($res->getMessage()); } @@ -80,7 +80,7 @@ </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[ <?php @@ -90,7 +90,7 @@ $res =& $db->query($sql, $data); -// Vérifiez toujours que $res n'est pas une erreur +// Vérifiez toujours que $res n'est pas une erreur if (DB::isError($res)) { die ($res->getMessage()); } http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-sequences.xml?r1=1.4&r2=1.5&ty=u Index: peardoc/fr/package/database/db/intro-sequences.xml diff -u peardoc/fr/package/database/db/intro-sequences.xml:1.4 peardoc/fr/package/database/db/intro-sequences.xml:1.5 --- peardoc/fr/package/database/db/intro-sequences.xml:1.4 Tue Jul 6 12:16:49 2004 +++ peardoc/fr/package/database/db/intro-sequences.xml Tue Jul 6 12:18:49 2004 @@ -1,44 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- 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> + <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 + 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>. + 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 + 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. + si une séquence n'existe pas elle sera créée automatiquement. <example> - <title>Utiliser une séquence</title> + <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 +// Utilisez l'identifiant dans votre requête $res =& $db->query("INSERT INTO myTable (id, text) VALUES ($id, 'foo')"); ?> ]]> @@ -50,17 +50,17 @@ <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 + 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 + 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">