cvs: peardoc /fr/package/database/db intro-execute.xml
| From: | Mehdi Achour | Date: | Mon, 23 Feb 2004 10:09:46 +0000 |
| Subject: | cvs: peardoc /fr/package/database/db intro-execute.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-2695@lists.php.net to get a copy of this message | ||
didou Mon Feb 23 05:09:46 2004 EDT
Modified files:
/peardoc/fr/package/database/db intro-execute.xml
Log:
sync with en
http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-execute.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/fr/package/database/db/intro-execute.xml diff -u peardoc/fr/package/database/db/intro-execute.xml:1.3 peardoc/fr/package/database/db/intro-execute.xml:1.4 --- peardoc/fr/package/database/db/intro-execute.xml:1.3 Sat Feb 21 22:42:04 2004 +++ peardoc/fr/package/database/db/intro-execute.xml Mon Feb 23 05:09:45 2004 @@ -1,5 +1,5 @@ -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.14 Maintainer: ThomasMoulard Status: EXAMPLES_ONLY --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.14 Maintainer: didou Status: ready --> <refentry id="package.database.db.intro-execute"> <refnamediv> <refname>Introduction - Exécuter</refname> @@ -12,18 +12,20 @@ <title>Objet</title> <para> <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> et + <function>prepare</function></link> et <link linkend="package.database.db.db-common.execute"> - <function>execute*</function></link> - vous donne le plus possible de puissance et de flexibilité pour l'exécution des requêtes. Vous - pouvez les utilisez si vous devez faire plus qu'une simple requête d'égalité - (par ex.. ajouter une liste d'adreses à votre base de donnée) ou si vous voulez - supporter plusieurs bases de données, qui ont différentes + <function>execute*</function></link> vous donne le plus + possible de puissance et de flexibilité pour + l'exécution des requêtes. Vous pouvez les + utiliser si vous devez faire plus qu'une simple requête + d'égalité (par ex.. ajouter une liste d'adreses + à votre base de donnée) ou si vous voulez supporter + plusieurs bases de données, qui ont différentes implantations du SQL standard. </para> <para> - Imgainez que vous souhaitez gérer deux différentes bases de données avec des syntaxes - différentes pour INSERT: + Imaginez que vous souhaitez gérer deux différentes + bases de données avec des syntaxes différentes pour INSERT: <programlisting> <![CDATA[ db1: INSERT INTO tbl_name (col1, col2) VALUES (expr1, expr2) @@ -47,18 +49,20 @@ <refsect2> <title>Prepare</title> <para> - Pour utiliser la fonctionnalité précédente, vous devez suivre deux étapes. La première est de + Pour utiliser la fonctionnalité précédente, vous + devez suivre deux étapes. La première est de <emphasis>preparer</emphasis> la requête et la seconde est de <emphasis>l'exécuter</emphasis>. </para> <para> <link linkend="package.database.db.db-common.prepare"> - <function>Prepare</function></link> doit être appelée avec la requête générique au moins - une fois. Il retourne un handle pour la requête. + <function>Prepare</function></link> doit être appelée avec + la requête générique au moins une fois. Il retourne + une ressource pour la requête. </para> <para> - Créer une requête générique est aisé. Ecrivez la requête SQL - comme d'habitude, par ex.: + Créer une requête générique est aisé. + Ecrivez la requête SQL comme d'habitude, par ex.: <programlisting> <![CDATA[ SELECT surnom, nom, age @@ -66,8 +70,9 @@ WHERE nom = 'name_a_trouver' AND age < 'limite_d_age' ]]> </programlisting> - Maintenant vérifiez que les paramètres peuvent être remplacée durant l'exécution du - script. Substituez ces paramètres par un marqueur. + Maintenant vérifiez que les paramètres peuvent être + remplacée durant l'exécution du script. Substituez ces + paramètres par un marqueur. <programlisting> <![CDATA[ SELECT surnom, nom, age @@ -75,18 +80,19 @@ WHERE nom = ? AND age < ? ]]> </programlisting> - Et voilà! Maintenant que vous avez votre requête générique nécessaire pour + Et voilà! Maintenant que vous avez votre requête + générique nécessaire pour <link linkend="package.database.db.db-common.prepare"> <function>prepare</function></link>. </para> <para> <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> peut gérer différents types de marqueurs ou - caractères jokers. + <function>prepare</function></link> peut gérer différents + types de marqueurs ou caractères jokers. <simplelist> <member> <parameter>?</parameter> - (recommendé) est mis pour une - valeur scalaire comme les chaînes ou nombre, la valeur sera + valeur scalaire comme les chaînes ou nombre, la valeur sera éventuellement mis entre apostrophes selon la base de donnée </member> <member> @@ -94,9 +100,10 @@ sera insérée dans la requête <quote>telle quelle</quote>. </member> <member> - <parameter>&</parameter> - nécessite un nom de fichier existant, + <parameter>&</parameter> - nécessite un nom de fichier existant, le contenu du fichier sera inclu dans la requête - (par ex. pour sauvegarder les données binaires d'une image dans la base de donnée) + (par ex. pour sauvegarder les données binaires d'une image dans la + base de données) </member> </simplelist> </para> @@ -104,21 +111,22 @@ <refsect2> <title>Execute/ ExecuteMultiple</title> <para> - Après avoir préparé la requête, vous pouvez l'exécuter. Cela - signifie assigner aux variabels des valeurs aux variables de la requête préparée. Pour se faire + Après avoir préparé la requête, vous pouvez + l'exécuter. Cela signifie assigner des valeurs aux variables de + la requête préparée. Pour se faire <link linkend="package.database.db.db-common.execute"> - <function>execute</function></link> a besoin de deux arguments, le - handle de la requête renvoyée <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> et un tableau - avec les valeurs à insérer. Le tableau doit être numéroté. - ordered. La première entrée du tableau représente le premier - caractère joker, le second le second caractère joker etc. L'ordre est + <function>execute</function></link> a besoin de deux arguments, la + ressource de la requête renvoyée <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link> et un tableau avec les valeurs à + insérer. Le tableau doit être ordonné. La première + entrée du tableau représente le premier caractère + joker, la seconde le second caractère joker etc.. L'ordre est indépendent du caractère joker utilisé. <example> <title>Insérer des données dans la base de donnée</title> <programlisting role="php"> <![CDATA[ -// Once you have a valid DB object named $db... +// On suppose que vous avez un objet valide nommé $db $alldata = array(array(1, 'one', 'en'), array(2, 'two', 'to'), array(3, 'three', 'tre'), @@ -150,7 +158,7 @@ </title> <programlisting role="php"> <![CDATA[ -// Once you have a valid DB object named $db... +// On suppose que vous avez un objet valide nommé $db $alldata = array(array(1, 'one', 'en'), array(2, 'two', 'to'), array(3, 'three', 'tre'), @@ -165,7 +173,7 @@ </para> <para> Si <link linkend="package.database.db.db-common.execute"> - <function>execute*</function></link> échoue, un objet + <function>execute*</function></link> échoue, un objet &class.db-error; est renvoyé, sinon &constant.db-ok; est renvoyé. </para> </refsect2> @@ -190,5 +198,5 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +-->
http://cvs.php.net/diff.php/peardoc/fr/package/database/db/intro-execute.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/fr/package/database/db/intro-execute.xml diff -u peardoc/fr/package/database/db/intro-execute.xml:1.3 peardoc/fr/package/database/db/intro-execute.xml:1.4 --- peardoc/fr/package/database/db/intro-execute.xml:1.3 Sat Feb 21 22:42:04 2004 +++ peardoc/fr/package/database/db/intro-execute.xml Mon Feb 23 05:09:45 2004 @@ -1,5 +1,5 @@ -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.14 Maintainer: ThomasMoulard Status: EXAMPLES_ONLY --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.14 Maintainer: didou Status: ready --> <refentry id="package.database.db.intro-execute"> <refnamediv> <refname>Introduction - Exécuter</refname> @@ -12,18 +12,20 @@ <title>Objet</title> <para> <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> et + <function>prepare</function></link> et <link linkend="package.database.db.db-common.execute"> - <function>execute*</function></link> - vous donne le plus possible de puissance et de flexibilité pour l'exécution des requêtes. Vous - pouvez les utilisez si vous devez faire plus qu'une simple requête d'égalité - (par ex.. ajouter une liste d'adreses à votre base de donnée) ou si vous voulez - supporter plusieurs bases de données, qui ont différentes + <function>execute*</function></link> vous donne le plus + possible de puissance et de flexibilité pour + l'exécution des requêtes. Vous pouvez les + utiliser si vous devez faire plus qu'une simple requête + d'égalité (par ex.. ajouter une liste d'adreses + à votre base de donnée) ou si vous voulez supporter + plusieurs bases de données, qui ont différentes implantations du SQL standard. </para> <para> - Imgainez que vous souhaitez gérer deux différentes bases de données avec des syntaxes - différentes pour INSERT: + Imaginez que vous souhaitez gérer deux différentes + bases de données avec des syntaxes différentes pour INSERT: <programlisting> <![CDATA[ db1: INSERT INTO tbl_name (col1, col2) VALUES (expr1, expr2) @@ -47,18 +49,20 @@ <refsect2> <title>Prepare</title> <para> - Pour utiliser la fonctionnalité précédente, vous devez suivre deux étapes. La première est de + Pour utiliser la fonctionnalité précédente, vous + devez suivre deux étapes. La première est de <emphasis>preparer</emphasis> la requête et la seconde est de <emphasis>l'exécuter</emphasis>. </para> <para> <link linkend="package.database.db.db-common.prepare"> - <function>Prepare</function></link> doit être appelée avec la requête générique au moins - une fois. Il retourne un handle pour la requête. + <function>Prepare</function></link> doit être appelée avec + la requête générique au moins une fois. Il retourne + une ressource pour la requête. </para> <para> - Créer une requête générique est aisé. Ecrivez la requête SQL - comme d'habitude, par ex.: + Créer une requête générique est aisé. + Ecrivez la requête SQL comme d'habitude, par ex.: <programlisting> <![CDATA[ SELECT surnom, nom, age @@ -66,8 +70,9 @@ WHERE nom = 'name_a_trouver' AND age < 'limite_d_age' ]]> </programlisting> - Maintenant vérifiez que les paramètres peuvent être remplacée durant l'exécution du - script. Substituez ces paramètres par un marqueur. + Maintenant vérifiez que les paramètres peuvent être + remplacée durant l'exécution du script. Substituez ces + paramètres par un marqueur. <programlisting> <![CDATA[ SELECT surnom, nom, age @@ -75,18 +80,19 @@ WHERE nom = ? AND age < ? ]]> </programlisting> - Et voilà! Maintenant que vous avez votre requête générique nécessaire pour + Et voilà! Maintenant que vous avez votre requête + générique nécessaire pour <link linkend="package.database.db.db-common.prepare"> <function>prepare</function></link>. </para> <para> <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> peut gérer différents types de marqueurs ou - caractères jokers. + <function>prepare</function></link> peut gérer différents + types de marqueurs ou caractères jokers. <simplelist> <member> <parameter>?</parameter> - (recommendé) est mis pour une - valeur scalaire comme les chaînes ou nombre, la valeur sera + valeur scalaire comme les chaînes ou nombre, la valeur sera éventuellement mis entre apostrophes selon la base de donnée </member> <member> @@ -94,9 +100,10 @@ sera insérée dans la requête <quote>telle quelle</quote>. </member> <member> - <parameter>&</parameter> - nécessite un nom de fichier existant, + <parameter>&</parameter> - nécessite un nom de fichier existant, le contenu du fichier sera inclu dans la requête - (par ex. pour sauvegarder les données binaires d'une image dans la base de donnée) + (par ex. pour sauvegarder les données binaires d'une image dans la + base de données) </member> </simplelist> </para> @@ -104,21 +111,22 @@ <refsect2> <title>Execute/ ExecuteMultiple</title> <para> - Après avoir préparé la requête, vous pouvez l'exécuter. Cela - signifie assigner aux variabels des valeurs aux variables de la requête préparée. Pour se faire + Après avoir préparé la requête, vous pouvez + l'exécuter. Cela signifie assigner des valeurs aux variables de + la requête préparée. Pour se faire <link linkend="package.database.db.db-common.execute"> - <function>execute</function></link> a besoin de deux arguments, le - handle de la requête renvoyée <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> et un tableau - avec les valeurs à insérer. Le tableau doit être numéroté. - ordered. La première entrée du tableau représente le premier - caractère joker, le second le second caractère joker etc. L'ordre est + <function>execute</function></link> a besoin de deux arguments, la + ressource de la requête renvoyée <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link> et un tableau avec les valeurs à + insérer. Le tableau doit être ordonné. La première + entrée du tableau représente le premier caractère + joker, la seconde le second caractère joker etc.. L'ordre est indépendent du caractère joker utilisé. <example> <title>Insérer des données dans la base de donnée</title> <programlisting role="php"> <![CDATA[ -// Once you have a valid DB object named $db... +// On suppose que vous avez un objet valide nommé $db $alldata = array(array(1, 'one', 'en'), array(2, 'two', 'to'), array(3, 'three', 'tre'), @@ -150,7 +158,7 @@ </title> <programlisting role="php"> <![CDATA[ -// Once you have a valid DB object named $db... +// On suppose que vous avez un objet valide nommé $db $alldata = array(array(1, 'one', 'en'), array(2, 'two', 'to'), array(3, 'three', 'tre'), @@ -165,7 +173,7 @@ </para> <para> Si <link linkend="package.database.db.db-common.execute"> - <function>execute*</function></link> échoue, un objet + <function>execute*</function></link> échoue, un objet &class.db-error; est renvoyé, sinon &constant.db-ok; est renvoyé. </para> </refsect2> @@ -190,5 +198,5 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +-->