cvs: peardoc /fr/package/database/db/db-common affectedrows.xml autoexecute.xml autoprepare.xml createsequence.xml disconnect.xml dropsequence.xml
escapesimple.xml execute.xml executemultiple.xml
| From: | Yannick TORRES | Date: | Tue, 06 Jul 2004 21:11:27 +0000 |
| Subject: | cvs: peardoc /fr/package/database/db/db-common affectedrows.xml autoexecute.xml autoprepare.xml createsequence.xml disconnect.xml dropsequence.xml escapesimple.xml execute.xml executemultiple.xml |
||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-4571@lists.php.net to get a copy of this message | ||
yannick Tue Jul 6 17:11:27 2004 EDT
Modified files:
/peardoc/fr/package/database/db/db-common affectedrows.xml
autoexecute.xml
autoprepare.xml
createsequence.xml
disconnect.xml
dropsequence.xml
escapesimple.xml
executemultiple.xml
execute.xml
Log:
sync with EN revision
http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/affectedrows.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/fr/package/database/db/db-common/affectedrows.xml diff -u peardoc/fr/package/database/db/db-common/affectedrows.xml:1.3 peardoc/fr/package/database/db/db-common/affectedrows.xml:1.4 --- peardoc/fr/package/database/db/db-common/affectedrows.xml:1.3 Fri Feb 20 11:30:19 2004 +++ peardoc/fr/package/database/db/db-common/affectedrows.xml Tue Jul 6 17:11:26 2004 @@ -1,77 +1,114 @@ -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.10 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.23 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.affectedrows"> - <refnamediv> - <refname>DB_common::affectedRows()</refname> - <refpurpose>Trouve le nombre de lignes affectées</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>integer <function>affectedRows</function></funcdef> - <paramdef></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.affectedrows.desc"> - &title.desc; - <para> - Nombre de lignes affectées par la requête. Cette - fonction retourne 0 pour les requêtes du type SELECT. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.affectedrows.return"> - &title.returns; - <para> - <parameter>integer</parameter> - nombre de lignes ou - &class.db-error; en cas d'echec - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.affectedrows.throws"> - &title.throws; - <para> - <table> - <title>&title.throws.errortable;</title> - <tgroup cols="4"> - <thead> - <row> - <entry>Code erreur</entry> - <entry>Message erreur</entry> - <entry>Raison</entry> - <entry>Solution</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>DB_ERROR_NOT_CAPABLE</constant></entry> - <entry> - &null; - </entry> - <entry> - La fonction n'est pas supportée par le moteur de base de données - </entry> - <entry> - Changez de gestionnaire de base de données, si vous avez vraiment - besoin de cette fonctionnalité. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.affectedrows.note"> - &title.note; - ¬e.notstatic; - </refsect1> - <refsect1 id="package.database.db.db-common.affectedrows.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.query"> - <function>query</function></link> - </para> - </refsect1> - </refentry> + <refnamediv> + <refname>DB_common::affectedRows()</refname> + <refpurpose>Trouve le nombre de lignes affectées</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>integer <function>affectedRows</function></funcdef> + <paramdef></paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.affectedrows.desc"> + &title.desc; + <para> + Nombre de lignes affectées par une requête qui manipule des données + (par exemple <command>INSERT</command>, + <command>UPDATE</command> ou <command>DELETE</command>). + Cette fonction retourne 0 pour les requêtes du type <command>SELECT</command>. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.affectedrows.return"> + &title.returns; + <para> + &type.int; - nombre de lignes ou + &class.db-error; en cas d'echec + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.affectedrows.throws"> + &title.throws; + <para> + <table> + <title>&title.throws.errortable;</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Code erreur</entry> + <entry>Message erreur</entry> + <entry>Raison</entry> + <entry>Solution</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>DB_ERROR_NOT_CAPABLE</constant></entry> + <entry> + DB backend not capable + </entry> + <entry> + La fonction n'est pas supportée par le moteur de base de données + </entry> + <entry> + Changez de gestionnaire de base de données, si vous avez vraiment + besoin de cette fonctionnalité. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.affectedrows.note"> + &title.note; + ¬e.notstatic; + </refsect1> + + <refsect1 id="package.database.db.db-common.affectedrows.example"> + &title.example; + <example> + <title>Exemple avec <function>affectedRows</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// En supposant que vous avez un objet DB valide nommé $db... +$res =& $db->query('DELETE * FROM clients'); + +if (DB::isError($res)) { + die($res->getMessage()); +} + +echo 'J\'ai effacé ' . $db->affectedRows() . ' clients'; +?> +]]> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.affectedrows.see"> + &title.see; + <para> + <link linkend="package.database.db.db-common.query"> + <function>query</function></link>, + <link linkend="package.database.db.db-common.execute"> + <function>execute</function></link>, + <link linkend="package.database.db.db-common.autoexecute"> + <function>autoExecute</function></link>, + <link linkend="package.database.db.db-common.executemultiple"> + <function>executeMultiple</function></link> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/autoexecute.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/db-common/autoexecute.xml diff -u peardoc/fr/package/database/db/db-common/autoexecute.xml:1.2 peardoc/fr/package/database/db/db-common/autoexecute.xml:1.3 --- peardoc/fr/package/database/db/db-common/autoexecute.xml:1.2 Fri Feb 20 11:30:19 2004 +++ peardoc/fr/package/database/db/db-common/autoexecute.xml Tue Jul 6 17:11:26 2004 @@ -1,41 +1,52 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.15 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.31 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.autoexecute"> <refnamediv> <refname>DB_common::autoExecute()</refname> - <refpurpose>Exécuter automatiquement les requêtes d'insertion ou de mise à jour</refpurpose> + <refpurpose> + Prépare et éxécute automatiquement les requêtes INSERT ou UPDATE + basées sur les variables fournies + </refpurpose> </refnamediv> + <refsynopsisdiv> <funcsynopsis> <funcprototype> - <funcdef>DB_result <function>autoExecute</function></funcdef> - <paramdef>string <parameter>$table</parameter></paramdef> - <paramdef>array <parameter>$fields_values</parameter></paramdef> + <funcdef>integer <function>autoExecute</function></funcdef> + <paramdef> + string <parameter>$table</parameter> + </paramdef> + <paramdef> + array <parameter>$fields_values</parameter> + </paramdef> <paramdef> integer <parameter><optional>$mode = - <constant>DB_AUTOQUERY_INSERT</constant></optional></parameter> + <constant>DB_AUTOQUERY_INSERT</constant></optional></parameter> + </paramdef> + <paramdef> + string <parameter><optional>$where = &false;</optional></parameter> </paramdef> - <paramdef>string <parameter><optional>$where = &false;</optional></parameter></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> + <refsect1 id="package.database.db.db-common.autoexecute.desc"> &title.desc; <para> <function>autoExecute</function> construit automatiquement une requête - d'insertion ou de mise à jour puis invoque - <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> avec. - La requête est construite en utilisant + INSERT ou UPDATE. + </para> + <para> + Cette méthode construit des requêtes SQL en utilisant <link linkend="package.database.db.db-common.autoprepare"> - <function>autoPrepare</function></link>. - Pour appeler autoExecute, vous n'avez besoin que d'un tableau associatif - (clef => valeur) où les clefs sont les noms des champs et les valeurs sont - les valeurs correspondantes à ces champs. + <function>autoPrepare</function></link> et les exécutent en utilisant + <link linkend="package.database.db.db-common.execute"> + <function>execute</function></link>. </para> </refsect1> + <refsect1 id="package.database.db.db-common.autoexecute.parameter"> &title.param; <para> @@ -58,7 +69,7 @@ </term> <listitem> <para> - tableau associatif (clef => valeur), les clefs sont les noms des champs + tableau associatif (clé => valeur), les clés sont les noms des champs et les valeurs sont les valeurs correspondantes à ces champs. </para> </listitem> @@ -83,8 +94,8 @@ </term> <listitem> <para> - in case of update queries, - this string will be put after the WHERE statement + dans le cas de requêtes de mise à jour, cette chaîne sera mise après la clause + <command>WHERE</command> </para> </listitem> </varlistentry> @@ -95,7 +106,7 @@ <refsect1 id="package.database.db.db-common.autoexecute.return"> &title.returns; <para> - <parameter>&class.db-result;</parameter> - un nouvel objet &class.db-result; + &type.int; - &constant.db-ok; en cas de succès ou un objet &class.db-error; en cas d'erreurs </para> </refsect1> @@ -117,24 +128,41 @@ <tbody> <row> <entry><constant>DB_ERROR_NEED_MORE_DATA</constant></entry> - <entry>&null;</entry> - <entry>Votre tableau associatif, qui doit contenir les noms des champs et leurs valeurs, est vide.</entry> - <entry>Vérifiez et corrigez votre tableau fields_values.</entry> + <entry> + insufficient data supplied + </entry> + <entry> + Votre tableau associatif, qui doit contenir les noms des champs + et leurs valeurs, est vide. + </entry> + <entry> + Vérifiez et corrigez votre tableau fields_values. + </entry> </row> <row> <entry><constant>DB_ERROR_SYNTAX</constant></entry> - <entry>&null;</entry> - <entry>Vous utilisez un mode inconnu.</entry> <entry> - Les modes disponibles sont <constant>DB_AUTOQUERY_INSERT</constant> pour - les insertions et <constant>DB_AUTOQUERY_UPDATE</constant> pour les mises - à jour. + syntax error + </entry> + <entry> + Vous utilisez un mode inconnu. + </entry> + <entry> + Les modes disponibles sont uniquement + <constant>DB_AUTOQUERY_INSERT</constant> pour + les requêtes <command>INSERT</command> ou + <constant>DB_AUTOQUERY_UPDATE</constant> pour + les requêtes <command>UPDATE</command>. </entry> </row> <row> <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> - <entry>&null;</entry> - <entry>Aucune base de données n'a été sélectionnée.</entry> + <entry> + no database selected + </entry> + <entry> + Aucune base de données n'a été sélectionnée. + </entry> <entry> Vérifiez le <link linkend="package.database.db.intro-dsn">DSN</link> dans <link linkend="package.database.db.db.connect"> @@ -145,7 +173,7 @@ <entry>tout autre code erreur</entry> <entry></entry> <entry> - Erreur spécifique à la base de données. + Erreur spécifique à la base de données </entry> <entry> Vérifiez la section spécifique à la base de données dans le @@ -163,16 +191,43 @@ <refsect1 id="package.database.db.db-common.autoexecute.note"> &title.note; ¬e.notstatic; - <para> - Voyez <link linkend="package.database.db.intro-auto">Introduction - - autoPrepare et autoExecute</link> pour les utilisations et les exemples. - </para> </refsect1> + <refsect1 id="package.database.db.db-common.autoexecute.example"> + &title.example; + <example> + <title>Exemple avec <function>autoExecute</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// En supposant que vous avez un objet DB valide nommé $db... +$table_name = 'user'; + +$fields_values = array( + 'id' => 1, + 'name' => 'Fabien', + 'country' => 'France' +); + +$res = $db->autoExecute($table_name, $fields_values, + DB_AUTOQUERY_INSERT); + +if (DB::isError($res)) { + die($res->getMessage()); +} +?> + ]]> + </programlisting> + </example> + </refsect1> <refsect1 id="package.database.db.db-common.autoexecute.see"> &title.see; <para> + <link linkend="package.database.db.intro-execute"> + <quote>Intro - Prepare & Execute</quote></link>, + <link linkend="package.database.db.intro-auto"> + <quote>Intro - autoPrepare & autoExecute</quote></link>, <link linkend="package.database.db.db-common.prepare"> <function>prepare</function></link>, <link linkend="package.database.db.db-common.execute"> @@ -183,9 +238,8 @@ <function>autoPrepare</function></link> </para> </refsect1> - - </refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/autoprepare.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/fr/package/database/db/db-common/autoprepare.xml diff -u peardoc/fr/package/database/db/db-common/autoprepare.xml:1.1 peardoc/fr/package/database/db/db-common/autoprepare.xml:1.2 --- peardoc/fr/package/database/db/db-common/autoprepare.xml:1.1 Sat Feb 21 21:04:07 2004 +++ peardoc/fr/package/database/db/db-common/autoprepare.xml Tue Jul 6 17:11:26 2004 @@ -1,18 +1,33 @@ -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.14 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.31 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.autoprepare"> <refnamediv> <refname>DB_common::autoPrepare()</refname> - <refpurpose>Construit et exécute une requête automatiquement</refpurpose> + <refpurpose> + Prépare une requête INSERT ou UPDATE + basée sur les variables fournies + </refpurpose> </refnamediv> + <refsynopsisdiv> <funcsynopsis> <funcprototype> <funcdef>resource <function>autoPrepare</function></funcdef> - <paramdef>string <parameter>$table</parameter></paramdef> - <paramdef>array <parameter>$table_fields</parameter></paramdef> - <paramdef>integer <parameter>$mode = <constant>DB_AUTOQUERY_INSERT</constant></parameter></paramdef> - <paramdef>string <parameter><optional>$where = &false;</optional></parameter></paramdef> + <paramdef> + string <parameter>$table</parameter> + </paramdef> + <paramdef> + array <parameter>$table_fields</parameter> + </paramdef> + <paramdef> + integer <parameter>$mode = + <constant>DB_AUTOQUERY_INSERT</constant></parameter> + </paramdef> + <paramdef> + string <parameter><optional>$where = &false;</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> @@ -21,11 +36,12 @@ &title.desc; <para> <function>autoPrepare</function> construit automatiquement une requête - d'insertion ou de mise à jour et apelle - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> avec. - La requête SQL est construire en utilisant un tableau ordonné contenant les - nom des champs. + <command>INSERT</command> ou <command>UPDATE</command> pour être + utilisée par + <link linkend="package.database.db.db-common.execute"> + <function>execute</function></link> ou + <link linkend="package.database.db.db-common.executemultiple"> + <function>executeMultiple</function></link>. </para> </refsect1> @@ -36,7 +52,7 @@ <varlistentry> <term> &type.string; - <parameter>string $table</parameter> + <parameter>$table</parameter> </term> <listitem> <para> @@ -74,8 +90,8 @@ </term> <listitem> <para> - si la requête est une mise à jour, cette chaîne sera ajoutée après la - clause WHERE + si la requête est une mise à jour, cette chaîne + sera ajoutée après la clause WHERE </para> </listitem> </varlistentry> @@ -86,7 +102,8 @@ <refsect1 id="package.database.db.db-common.autoprepare.return"> &title.returns; <para> - <parameter>resource</parameter> - ressource utilisée pour la requête + &type.resource; - ressource utilisée pour la requête + ou un objet &class.db-error; en cas d'échec </para> </refsect1> @@ -107,7 +124,9 @@ <tbody> <row> <entry><constant>DB_ERROR_NEED_MORE_DATA</constant></entry> - <entry>&null;</entry> + <entry> + insufficient data supplied + </entry> <entry> Le tableau qui doit contenir les noms de champs est vide. </entry> @@ -117,18 +136,27 @@ </row> <row> <entry><constant>DB_ERROR_SYNTAX</constant></entry> - <entry>&null;</entry> + <entry> + syntax error + </entry> <entry>Vous utilisez un mode inconnu.</entry> <entry> - Les modes disponibles sont <constant>DB_AUTOQUERY_INSERT</constant> pour - les insertions et <constant>DB_AUTOQUERY_UPDATE</constant> pour les mises - à jour. + Les modes disponibles sont uniquement + <constant>DB_AUTOQUERY_INSERT</constant> pour + les requêtes <command>INSERT</command> ou + <constant>DB_AUTOQUERY_UPDATE</constant> pour + les requêtes <command>UPDATE</command>. </entry> </row> <row> <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> - <entry>&null;</entry> - <entry>Aucune base de données n'a été sélectionnée.</entry> + <entry> + no database selected + </entry> + <entry> + Aucune base de données + n'a été sélectionnée. + </entry> <entry> Vérifiez le <link linkend="package.database.db.intro-dsn">DSN</link> dans <link linkend="package.database.db.db.connect"> @@ -150,23 +178,53 @@ </tbody> </tgroup> </table> - </para> + </para> </refsect1> <refsect1 id="package.database.db.db-common.autoprepare.note"> &title.note; ¬e.notstatic; - <para> - Voyez <link linkend="package.database.db.intro-auto">Introduction - - autoPrepare et autoExecute</link> pour les utilisations et les exemples. - </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.autoprepare.example"> + &title.example; + <example> + <title>Exemple avec <function>autoPrepare</function></title> + <programlisting role="php"> + <![CDATA[ +<?php +// En supposant que vous avez un objet DB valide nommé $db... +$table_name = 'user'; +$table_fields = array('name', 'country'); +$table_values = array('Bob', 'USA'); + +$sth = $db->autoPrepare($table_name, $table_fields, + DB_AUTOQUERY_UPDATE, 'id = 1'); + +if (DB::isError($sth)) { + die($sth->getMessage()); +} + +$res =& $db->execute($sth, $table_values); + +if (DB::isError($res)) { + die($res->getMessage()); +} +?> + ]]> + </programlisting> + </example> </refsect1> <refsect1 id="package.database.db.db-common.autoprepare.see"> &title.see; <para> + <link linkend="package.database.db.intro-execute"> + <quote>Intro - Prepare & Execute</quote></link>, + <link linkend="package.database.db.intro-auto"> + <quote>Intro - autoPrepare & autoExecute</quote></link>, <link linkend="package.database.db.db-common.prepare"> <function>prepare</function></link>, <link linkend="package.database.db.db-common.execute"> @@ -177,8 +235,6 @@ <function>autoExecute</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/db-common/createsequence.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/db-common/createsequence.xml diff -u peardoc/fr/package/database/db/db-common/createsequence.xml:1.2 peardoc/fr/package/database/db/db-common/createsequence.xml:1.3 --- peardoc/fr/package/database/db/db-common/createsequence.xml:1.2 Fri Feb 20 11:30:19 2004 +++ peardoc/fr/package/database/db/db-common/createsequence.xml Tue Jul 6 17:11:26 2004 @@ -1,95 +1,129 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.9 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.18 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.createsequence"> - <refnamediv> - <refname>DB_common::createSequence()</refname> - <refpurpose>Créé une nouvelle séquence</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>integer <function>createSequence</function></funcdef> - <paramdef>string <parameter>$seq_name</parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.createsequence.desc"> - &title.desc; - <para> - Voyez <link - linkend="package.database.db.intro-sequences"><quote>Introduction - Séquences</quote></link> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.createsequence.parameter"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - &type.string; - <parameter>$seq_name</parameter> - </term> - <listitem> - <para> - nom de la nouvelle séquence à créer - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.createsequence.return"> - &title.returns; - <para> - <parameter>integer</parameter> - &constant.db-ok; - ou &class.db-error; en cas d'echec. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.createsequence.throws"> - &title.throws; - <para> - <table> - <title>&title.throws.errortable;</title> - <tgroup cols="4"> - <thead> - <row> - <entry>Code erreur</entry> - <entry>Message erreur</entry> - <entry>Raison</entry> - <entry>Solution</entry> - </row> - </thead> - <tbody> - <row> - <entry>tout code erreur</entry> - <entry></entry> - <entry> - Erreur spécifique à la base de données - </entry> - <entry> - Vérifiez le nom de la séquence. Si il est correct, il s'agit - probablement d'un bogue dans l'implémentation de la séquence. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.createsequence.note"> - &title.note; - ¬e.notstatic; - </refsect1> - <refsect1 id="package.database.db.db-common.createsequence.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.nextid"> - <function>DB::nextId</function></link>, - <link linkend="package.database.db.db-common.dropsequence"> - <function>DB::dropSequence</function></link> - </para> - </refsect1> - </refentry> + <refnamediv> + <refname>DB_common::createSequence()</refname> + <refpurpose>Créé une nouvelle séquence</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>integer <function>createSequence</function></funcdef> + <paramdef> + string <parameter>$seq_name</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.createsequence.desc"> + &title.desc; + <para> + Voyez <link + linkend="package.database.db.intro-sequences"><quote>Introduction - Séquences</quote></link> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.createsequence.parameter"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.string; + <parameter>$seq_name</parameter> + </term> + <listitem> + <para> + nom de la nouvelle séquence à créer + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.createsequence.return"> + &title.returns; + <para> + &type.int; - &constant.db-ok; + ou un objet &class.db-error; en cas d'echec. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.createsequence.throws"> + &title.throws; + <para> + <table> + <title>&title.throws.errortable;</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Code erreur</entry> + <entry>Message erreur</entry> + <entry>Raison</entry> + <entry>Solution</entry> + </row> + </thead> + <tbody> + <row> + <entry>every error code</entry> + <entry></entry> + <entry> + Erreur spécifique à la base de données + </entry> + <entry> + Vérifiez le nom de la séquence. S'il est correct, il s'agit + probablement d'un bogue dans l'implémentation de la séquence. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.createsequence.note"> + &title.note; + ¬e.notstatic; + </refsect1> + + <refsect1 id="package.database.db.db-common.createsequence.example"> + &title.example; + <example> + <title>Exemple avec <function>createSequence</function></title> + <programlisting role="php"> + <![CDATA[ +<?php +// En supposant que vous avez un objet DB valide nommé $db... +$tmp = $db->createSequence('mySequence'); + +if (DB::isError($tmp)) { + die($tmp->getMessage()); +} +?> + ]]> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.createsequence.see"> + &title.see; + <para> + <link + linkend="package.database.db.intro-sequences"><quote>Introduction - + Séquences</quote></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: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/disconnect.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/db-common/disconnect.xml diff -u peardoc/fr/package/database/db/db-common/disconnect.xml:1.2 peardoc/fr/package/database/db/db-common/disconnect.xml:1.3 --- peardoc/fr/package/database/db/db-common/disconnect.xml:1.2 Fri Feb 20 11:30:19 2004 +++ peardoc/fr/package/database/db/db-common/disconnect.xml Tue Jul 6 17:11:26 2004 @@ -1,44 +1,73 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.9 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.19 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.disconnect"> - <refnamediv> - <refname>DB_common::disconnect()</refname> - <refpurpose>Termine la connexion à la base de données</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>boolean <function>disconnect</function></funcdef> - <paramdef></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.disconnect.desc"> - &title.desc; - <para> - Termine la connexion à la base de données. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.disconnect.return"> - &title.returns; - <para> - <parameter>boolean</parameter> - &return.success; - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.disconnect.note"> - &title.note; - ¬e.notstatic; - </refsect1> - <refsect1 id="package.database.db.db-common.disconnect.see"> - &title.see; - <para> - <link linkend="package.database.db.db.connect"> - <function>DB::connect</function></link>, - <link linkend="package.database.db.intro-connect"> - <function>Tutorial - Connect</function></link> - </para> - </refsect1> - </refentry> + <refnamediv> + <refname>DB_common::disconnect()</refname> + <refpurpose>Termine la connexion à la base de données</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>disconnect</function></funcdef> + <paramdef></paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.disconnect.desc"> + &title.desc; + <para> + Termine la connexion à la base de données. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.disconnect.return"> + &title.returns; + <para> + &type.bool; - &return.success; + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.disconnect.note"> + &title.note; + ¬e.notstatic; + </refsect1> + + <refsect1 id="package.database.db.db-common.disconnect.example"> + &title.example; + <example> + <title>Exemple avec <function>disconnect</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +require_once 'DB.php'; + +$db =& DB::connect('pgsql://someuser:apasswd@localhost/thedb'); +if (DB::isError($db)) { + die($db->getMessage()); +} + +$db->disconnect(); +?> + ]]> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.disconnect.see"> + &title.see; + <para> + <link linkend="package.database.db.db.connect"> + <function>connexion</function></link>, + <link linkend="package.database.db.intro-connect"> + <quote>Introduction - Connexion</quote></link> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/dropsequence.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/fr/package/database/db/db-common/dropsequence.xml diff -u peardoc/fr/package/database/db/db-common/dropsequence.xml:1.1 peardoc/fr/package/database/db/db-common/dropsequence.xml:1.2 --- peardoc/fr/package/database/db/db-common/dropsequence.xml:1.1 Sat Feb 21 21:04:07 2004 +++ peardoc/fr/package/database/db/db-common/dropsequence.xml Tue Jul 6 17:11:26 2004 @@ -1,101 +1,130 @@ -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.9 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.17 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.dropsequence"> - <refnamediv> - <refname>DB_common::dropSequence()</refname> - <refpurpose>Supprime une séquence</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>integer <function>dropSequence</function></funcdef> - <paramdef>string <parameter>$seqName</parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.dropsequence.desc"> - &title.desc; - <para> - Voyez <link - linkend="package.database.db.intro-sequences"><quote>Introduction - Séquences</quote></link> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.dropsequence.parameter"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - &type.string; - <parameter>$seqName</parameter> - </term> - <listitem> - <para> - nom de la séquence à supprimer - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.dropsequence.return"> - &title.returns; - <para> - <itemizedlist> + <refnamediv> + <refname>DB_common::dropSequence()</refname> + <refpurpose>Supprime une séquence</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>integer <function>dropSequence</function></funcdef> + <paramdef> + string <parameter>$seqName</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.dropsequence.desc"> + &title.desc; + <para> + Voyez <link + linkend="package.database.db.intro-sequences"><quote>Introduction - + Séquences</quote></link> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.dropsequence.parameter"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.string; + <parameter>$seqName</parameter> + </term> <listitem> <para> - <parameter>integer</parameter> - &constant.db-ok; - ou &class.db-error; en cas d'erreurs + nom de la séquence à supprimer </para> </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.dropsequence.throws"> - &title.throws; - <para> - <table> - <title>&title.throws.errortable;</title> - <tgroup cols="4"> - <thead> - <row> - <entry>Code erreur</entry> - <entry>Message erreur</entry> - <entry>Raison</entry> - <entry>Solution</entry> - </row> - </thead> - <tbody> - <row> - <entry>tout code erreur</entry> - <entry></entry> - <entry> - Erreur spécifique à la base de données. - </entry> - <entry> - Vérifiez le nom de la séquence. Si il est correct, il s'agit - probablement d'un bogue dans l'implémentation de la séquence. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.dropsequence.note"> - &title.note; - ¬e.notstatic; - </refsect1> - <refsect1 id="package.database.db.db-common.dropsequence.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.createsequence"> - <function>DB_common::createSequence</function></link>, - <link linkend="package.database.db.db-common.nextid"> - <function>DB_common::nextId</function></link> - </para> - </refsect1> - </refentry> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.dropsequence.return"> + &title.returns; + <para> + &type.int; - &constant.db-ok; + ou un objet &class.db-error; en cas d'erreur + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.dropsequence.throws"> + &title.throws; + <para> + <table> + <title>&title.throws.errortable;</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Code erreur</entry> + <entry>Message erreur</entry> + <entry>Raison</entry> + <entry>Solution</entry> + </row> + </thead> + <tbody> + <row> + <entry>tout code erreur</entry> + <entry></entry> + <entry> + Erreur spécifique à la base de données. + </entry> + <entry> + Vérifiez le nom de la séquence. S'il est correct, il s'agit + probablement d'un bogue dans l'implémentation de la séquence. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.dropsequence.note"> + &title.note; + ¬e.notstatic; + </refsect1> + + <refsect1 id="package.database.db.db-common.dropsequence.example"> + &title.example; + <example> + <title>Exemple avec <function>dropSequence</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// En supposant que vous avez un objet DB valide nommé $db... +$tmp = $db->dropSequence('mySequence'); + +if (DB::isError($tmp)) { + die($tmp->getMessage()); +} +?> +]]> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.dropsequence.see"> + &title.see; + <para> + <link + linkend="package.database.db.intro-sequences"><quote>Intro - + Sequences</quote></link>, + <link linkend="package.database.db.db-common.createsequence"> + <function>createSequence</function></link>, + <link linkend="package.database.db.db-common.nextid"> + <function>nextId</function></link> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/escapesimple.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/db-common/escapesimple.xml diff -u peardoc/fr/package/database/db/db-common/escapesimple.xml:1.2 peardoc/fr/package/database/db/db-common/escapesimple.xml:1.3 --- peardoc/fr/package/database/db/db-common/escapesimple.xml:1.2 Fri Feb 20 11:30:19 2004 +++ peardoc/fr/package/database/db/db-common/escapesimple.xml Tue Jul 6 17:11:26 2004 @@ -1,61 +1,71 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.17 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.escapesimple"> - <refnamediv> - <refname>DB_common::escapeSimple()</refname> - <refpurpose>Protège une chaîne en accord avec les standards du gestionnaire utilisé</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>escapeSimple</function></funcdef> - <paramdef>string <parameter>$str</parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.escapesimple.desc"> - &title.desc; - <para> - Protège une chaîne en accord avec les standards du gestionnaire utilisé. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.escapesimple.parameter"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - &type.string; - <parameter>$str</parameter> - </term> - <listitem> - <para> - la chaîne à protéger - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.escapesimple.return"> - &title.returns; - <para> - <parameter>string</parameter> - la chaîne protégée - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.escapesimple.note"> - &title.note; - ¬e.notstatic; - <simpara> - Fonction disponible depuis la version 1.6.0 - </simpara> - </refsect1> - <refsect1 id="package.database.db.db-common.escapesimple.example"> - &title.example; - <example> - <title>Utilisation de <function>escapeSimple</function></title> - <programlisting role="php"> - <![CDATA[ + <refnamediv> + <refname>DB_common::escapeSimple()</refname> + <refpurpose>Protège une chaîne en accord avec les standards du gestionnaire utilisé</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>escapeSimple</function></funcdef> + <paramdef> + string <parameter>$str</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.escapesimple.desc"> + &title.desc; + <para> + Protège une chaîne en accord avec les standards du gestionnaire utilisé. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.escapesimple.parameter"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.string; + <parameter>$str</parameter> + </term> + <listitem> + <para> + la chaîne à protéger + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.escapesimple.return"> + &title.returns; + <para> + &type.string; - la chaîne protégée + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.escapesimple.note"> + &title.note; + ¬e.notstatic; + <simpara> + Fonction disponible depuis la version 1.6.0 + </simpara> + </refsect1> + + <refsect1 id="package.database.db.db-common.escapesimple.example"> + &title.example; + <example> + <title>Utilisation de <function>escapeSimple</function></title> + <programlisting role="php"> +<![CDATA[ <?php // On suppose que $db est un objet DB valide... $name = "all's well"; @@ -65,17 +75,21 @@ $result =& $db->query($sql); ?> ]]> - </programlisting> - </example> - </refsect1> - <refsect1 id="package.database.db.db-common.escapesimple.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.quotesmart"> - <function>quoteSmart</function></link> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.escapesimple.see"> + &title.see; + <para> + <link linkend="package.database.db.db-common.quoteidentifier"> + <function>quoteIdentifier</function></link>, + <link linkend="package.database.db.db-common.quotesmart"> + <function>quoteSmart</function></link> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/executemultiple.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/db-common/executemultiple.xml diff -u peardoc/fr/package/database/db/db-common/executemultiple.xml:1.2 peardoc/fr/package/database/db/db-common/executemultiple.xml:1.3 --- peardoc/fr/package/database/db/db-common/executemultiple.xml:1.2 Mon Feb 23 18:09:20 2004 +++ peardoc/fr/package/database/db/db-common/executemultiple.xml Tue Jul 6 17:11:26 2004 @@ -1,177 +1,230 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.12 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.28 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.executemultiple"> - <refnamediv> - <refname>DB_common::executeMultiple()</refname> - <refpurpose>Exécute plusieurs fois une requête SQL préparée</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>executeMultiple</function></funcdef> - <paramdef>resource <parameter>$stmt</parameter></paramdef> - <paramdef>array <parameter>$data</parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.executemultiple.desc"> - &title.desc; - <para> - <function>executeMultiple</function> remplit la requête SQL préparée avec - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> avec les données fournies puis - exécute la requête pour chaque <quote>ligne</quote> du tableau - <parameter>$data</parameter>. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.executemultiple.parameter"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - &type.res; - <parameter>$stmt</parameter> - </term> - <listitem> - <para> - identifiant de ressource de requête retourné par - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - &type.array; - <parameter>array $data</parameter> - </term> - <listitem> - <para> - un tableau numérique contenant les données à insérer dans la requête - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.executemultiple.return"> - &title.returns; - <para> - <parameter>mixed</parameter> - un nouveau &class.db-result;/&constant.db-ok; - ou un &class.db-error; en cas d'echec - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.executemultiple.throws"> - &title.throws; - <para> - <table> - <title>&title.throws.errortable;</title> - <tgroup cols="4"> - <thead> - <row> - <entry>Code erreur</entry> - <entry>Message erreur</entry> - <entry>Raison</entry> - <entry>Solution</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>DB_ERROR_INVALID</constant></entry> - <entry> - &null; - </entry> - <entry> - SQL statment handle is not valid. - </entry> - <entry> - Vérifiez que la requête fonctionne bien avec - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>. Notez que - <function>executeMultiple</function> requière une - ressource de requête retournée par <link - linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>, - et non pas la requête elle-même. - </entry> - </row> - <row> - <entry><constant>DB_ERROR_MISMATCH</constant></entry> - <entry> - &null; - </entry> - <entry> - Pas assez de données pour préparer la requête - SQL. - </entry> - <entry> - Vérifiez le nombre de marqueurs dans la requête - <link linkend="package.database.db.db-common.prepare"> - passée à <function>prepare</function></link>. - Vérifiez le nombre d'éléments du tableau - <parameter>$data</parameter>. Il doit être égal au nombre - de marqueurs. - </entry> - </row> - <row> - <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> - <entry> - &null; - </entry> - <entry> - Aucune base de données n'a été sélectionnée. - </entry> - <entry> - Vérifiez le <link linkend="package.database.db.intro-dsn">DSN</link> - dans <link linkend="package.database.db.db.connect"> - <function>connect</function></link>. - </entry> - </row> - <row> - <entry>tout autre code erreur</entry> - <entry></entry> - <entry> - Erreur spécifique à la base de données. - </entry> - <entry> - Vérifiez la section spécifique à la base de données dans le - <ulink url="www.php.net/manual/">manuel PHP</ulink> - pour trouver la raison de cette erreur. Dans la plupart des cas, il - s'agit d'une requête mal formée. Comme l'utilisation de LIMIT dans - une requête envoyée à une base de données Oracle. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.executemultiple.note"> - &title.note; - ¬e.notstatic; - <warning> - <para> - Si une erreur se produit durant l'exécution, la fonction s'arretera. Il - se peut qu'il reste alors des données non traitées. - </para> - </warning> - <para> - Voyez <link linkend="package.database.db.intro-execute"> - Introduction - Execute</link> pour un cas d'utilisation général et un - exemple. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.executemultiple.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>, - <link linkend="package.database.db.db-common.execute"> - <function>execute</function></link> - </para> - </refsect1> - </refentry> + <refnamediv> + <refname>DB_common::executeMultiple()</refname> + <refpurpose>Exécute une requête préparée SQL pour chaque élément d'un tableau</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>executeMultiple</function></funcdef> + <paramdef> + resource <parameter>$stmt</parameter> + </paramdef> + <paramdef> + array <parameter>$data</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.executemultiple.desc"> + &title.desc; + <para> + Passe automatiquement les informations contenues dans + <parameter>$data</parameter> (un tableau multi-dimentionnel) à + <link linkend="package.database.db.db-common.execute"> + <function>execute</function></link>, qui exécute la requête soumise à + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.executemultiple.parameter"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.res; + <parameter>$stmt</parameter> + </term> + <listitem> + <para> + identifiant de ressource de requête retourné par + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + &type.array; + <parameter>$data</parameter> + </term> + <listitem> + <para> + un tableau numérique contenant les données + à insérer dans la requête + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.executemultiple.return"> + &title.returns; + <para> + &type.mixed; - 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> + </refsect1> + + <refsect1 id="package.database.db.db-common.executemultiple.throws"> + &title.throws; + <para> + <table> + <title>&title.throws.errortable;</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Code erreur</entry> + <entry>Message erreur</entry> + <entry>Raison</entry> + <entry>Solution</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>DB_ERROR_INVALID</constant></entry> + <entry> + invalid + </entry> + <entry> + la ressource de la requête SQL n'est pas valide. + </entry> + <entry> + Vérifiez que la requête fonctionne bien avec + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>. Notez que + <function>executeMultiple</function> requière une + ressource de requête retournée par <link + linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>, + et non pas la requête elle-même. + </entry> + </row> + <row> + <entry><constant>DB_ERROR_MISMATCH</constant></entry> + <entry> + mismatch + </entry> + <entry> + Pas assez de données pour préparer la requête + SQL. + </entry> + <entry> + Vérifiez que le nombre de marqueurs dans la requête + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link> passée à + <parameter>$query</parameter> est égal au nombre d'entrées + passées par <parameter>$params</parameter>. + </entry> + </row> + <row> + <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> + <entry> + no database selected + </entry> + <entry> + Aucune base de données n'a été sélectionnée. + </entry> + <entry> + Vérifiez le <link linkend="package.database.db.intro-dsn">DSN</link> + dans <link linkend="package.database.db.db.connect"> + <function>connect</function></link>. + </entry> + </row> + <row> + <entry>tout autre code erreur</entry> + <entry></entry> + <entry> + Erreur spécifique à la base de données. + </entry> + <entry> + Vérifiez la section spécifique à la base de données dans le + <ulink url="www.php.net/manual/">manuel PHP</ulink> + pour trouver la raison de cette erreur. Dans la plupart des cas, il + s'agit d'une requête mal formée, comme l'utilisation de LIMIT dans + une requête envoyée à une base de données Oracle. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.executemultiple.note"> + &title.note; + ¬e.notstatic; + <warning> + <para> + Si une erreur se produit durant l'exécution, la fonction s'arretera. Il + se peut qu'il reste alors des données non traitées. + </para> + </warning> + </refsect1> + + <refsect1 id="package.database.db.db-common.executemultiple.example"> + &title.example; + <example> + <title>Exemple avec <function>executeMultiple</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// On suppose que $db est un objet DB valide... +$sth = $db->prepare('INSERT INTO numbers VALUES (?, ?, ?)'); + +if (DB::isError($sth)) { + die($sth->getMessage()); +} + +$alldata = array(array(1, 'one', 'en'), + array(2, 'two', 'to'), + array(3, 'three', 'tre'), + array(4, 'four', 'fire')); + +$res =& $db->executeMultiple($sth, $alldata); + +if (DB::isError($res)) { + die($res->getMessage()); +} +?> +]]> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.executemultiple.see"> + &title.see; + <para> + <link linkend="package.database.db.intro-execute"> + <quote>Introduction - Préparation & Exécution</quote></link>, + <link linkend="package.database.db.intro-auto"> + <quote>Introduction - autoPrepare & autoExecute</quote></link>, + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>, + <link linkend="package.database.db.db-common.execute"> + <function>execute</function></link>, + <link linkend="package.database.db.db-common.autoprepare"> + <function>autoPrepare</function></link>, + <link linkend="package.database.db.db-common.autoexecute"> + <function>autoExecute</function></link> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/execute.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/db-common/execute.xml diff -u peardoc/fr/package/database/db/db-common/execute.xml:1.2 peardoc/fr/package/database/db/db-common/execute.xml:1.3 --- peardoc/fr/package/database/db/db-common/execute.xml:1.2 Mon Feb 23 18:09:20 2004 +++ peardoc/fr/package/database/db/db-common/execute.xml Tue Jul 6 17:11:26 2004 @@ -1,168 +1,228 @@ -<!-- $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.29 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.execute"> - <refnamediv> - <refname>DB_common::execute()</refname> - <refpurpose>Exécute une requête SQL préparée</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>object <function>&execute</function></funcdef> - <paramdef>resource <parameter>$stmt</parameter></paramdef> - <paramdef>array <parameter>$data</parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.execute.desc"> - &title.desc; - <para> - <function>execute</function> remplis la requête SQL préparée par - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> avec les données fournies puis - exécute la requête. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.execute.parameter"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - &type.res; - <parameter>$stmt</parameter> - </term> - <listitem> - <para> - ressource de requête retournée par - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function> - </link> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - &type.array; - <parameter>array $data</parameter> - </term> - <listitem> - <para> - un tableau numérique contenant les données à insérer dans la requête - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.execute.return"> - &title.returns; - <para> - <parameter>mixed</parameter> - un nouveau &class.db-result;/&constant.db-ok; - ou un &class.db-error; en cas d'erreurs - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.execute.throws"> - &title.throws; - <para> - <table> - <title>&title.throws.errortable;</title> - <tgroup cols="4"> - <thead> - <row> - <entry>Code erreur</entry> - <entry>Message erreur</entry> - <entry>Raison</entry> - <entry>Solution</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>DB_ERROR_INVALID</constant></entry> - <entry> - &null; - </entry> - <entry> - la ressource de requête SQL n'est pas valide - </entry> - <entry> - Vérifiez que la requête fonctionne bien avec - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>. Notez que - <function>execute</function> requière une ressource de requête - retournée par <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>, et non pas la requête - elle-même. - </entry> - </row> - <row> - <entry><constant>DB_ERROR_MISMATCH</constant></entry> - <entry> - &null; - </entry> - <entry> - Pas assez de données pour préparer la requête SQL. - </entry> - <entry> - Vérifiez le nombre de marqueurs dans la requête - <link linkend="package.database.db.db-common.prepare"> passée à - <function>prepare</function></link>. Vérifiez le nombre d'éléments - du tableau <parameter>$data</parameter>. Il doit être égal au nombre - de marqueurs. - </entry> - </row> - <row> - <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> - <entry> - &null; - </entry> - <entry> - Aucune base de données n'a été sélectionnée. - </entry> - <entry> - Vérifiez le <link linkend="package.database.db.intro-dsn">DSN</link> - dans <link linkend="package.database.db.db.connect"> - <function>connect</function></link>. - </entry> - </row> - <row> - <entry>tout autre code erreur</entry> - <entry></entry> - <entry> - Erreur spécifique à la base de données. - </entry> - <entry> - Vérifiez la section spécifique à la base de données dans le - <ulink url="www.php.net/manual/">manuel PHP</ulink> - pour trouver la raison de cette erreur. Dans la plupart des cas, il - s'agit d'une requête mal formée. Comme l'utilisation de LIMIT dans - une requête envoyée à une base de données Oracle. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.execute.note"> - &title.note; - ¬e.notstatic; - <para> - Voyez <link linkend="package.database.db.intro-execute"> - Introduction - Execute</link> pour les cas d'utilisation générale et un - exemple. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.execute.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>, - <link linkend="package.database.db.db-common.executemultiple"> - <function>executeMultiple</function></link> - </para> - </refsect1> - </refentry> + <refnamediv> + <refname>DB_common::execute()</refname> + <refpurpose>Exécute une requête SQL préparée</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>&execute</function></funcdef> + <paramdef> + resource <parameter>$stmt</parameter> + </paramdef> + <paramdef> + mixed <parameter><optional>$data = array()</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.execute.desc"> + &title.desc; + <para> + <function>execute</function> remplis la requête SQL préparée par + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link> avec les données fournies par + <parameter>$data</parameter> puis + exécute la requête. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.parameter"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.res; + <parameter>$stmt</parameter> + </term> + <listitem> + <para> + ressource de requête retournée par + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function> + </link> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + &type.mixed; + <parameter>$data</parameter> + </term> + <listitem> + <para> + tableau, chaîne de caractères ou donnée numérique contenant + les données à insérer dans la requête. + Le nombre d'éléments passées doit correspondre au nombre de marqueurs + de la requête préparée : 1 marqueur par paramètres (sauf tableau) ou + 1 marqueur par élément de tableau. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.return"> + &title.returns; + <para> + &type.mixed; - 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'échec. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.throws"> + &title.throws; + <para> + <table> + <title>&title.throws.errortable;</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Code erreur</entry> + <entry>Message erreur</entry> + <entry>Raison</entry> + <entry>Solution</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>DB_ERROR_INVALID</constant></entry> + <entry> + invalid + </entry> + <entry> + la ressource de requête SQL n'est pas valide + </entry> + <entry> + Vérifiez que la requête fonctionne bien avec + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>. Notez que + <function>execute</function> requière une ressource de requête + retournée par <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>, et non pas la requête + elle-même. + </entry> + </row> + <row> + <entry><constant>DB_ERROR_MISMATCH</constant></entry> + <entry> + mismatch + </entry> + <entry> + Pas assez de données pour préparer la requête SQL. + </entry> + <entry> + Vérifiez que le nombre de marqueurs dans la requête + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link> passée à + <parameter>$query</parameter> correspond au nombre d'entrées passées à + <parameter>$params</parameter>. + </entry> + </row> + <row> + <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> + <entry> + no database selected + </entry> + <entry> + Aucune base de données n'a été sélectionnée. + </entry> + <entry> + Vérifiez le <link linkend="package.database.db.intro-dsn">DSN</link> + dans <link linkend="package.database.db.db.connect"> + <function>connect</function></link>. + </entry> + </row> + <row> + <entry>tout autre code erreur</entry> + <entry></entry> + <entry> + Erreur spécifique à la base de données. + </entry> + <entry> + Vérifiez la section spécifique à la base de données dans le + <ulink url="www.php.net/manual/">manuel PHP</ulink> + pour trouver la raison de cette erreur. Dans la plupart des cas, il + s'agit d'une requête mal formée, comme l'utilisation de LIMIT dans + une requête envoyée à une base de données Oracle. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.note"> + &title.note; + ¬e.notstatic; + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.example"> + &title.example; + <example> + <title>Exemple en passant un scalaire à <function>execute</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// On suppose que $db est un objet DB valide... +$sth = $db->prepare('INSERT INTO numbers (number) VALUES (?)'); +if (DB::isError($sth)) { + die($sth->getMessage()); +} + +$res =& $db->execute($sth, 1); +if (DB::isError($res)) { + die($res->getMessage()); +} +?> +]]> + </programlisting> + </example> + + <example> + <title>Exemple en passant un tableau à <function>execute</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// On suppose que $db est un objet DB valide... +$sth = $db->prepare('INSERT INTO numbers VALUES (?, ?, ?)'); + +$data = array(1, 'one', 'en'); +$db->execute($sth, $data); +?> +]]> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.see"> + &title.see; + <para> + <link linkend="package.database.db.intro-execute"> + <quote>Introduction - Préparation & Exécution</quote></link>, + <link linkend="package.database.db.intro-auto"> + <quote>Intro - autoPrepare & autoExecute</quote></link>, + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>, + <link linkend="package.database.db.db-common.executemultiple"> + <function>executeMultiple</function></link> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml
http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/affectedrows.xml?r1=1.3&r2=1.4&ty=u Index: peardoc/fr/package/database/db/db-common/affectedrows.xml diff -u peardoc/fr/package/database/db/db-common/affectedrows.xml:1.3 peardoc/fr/package/database/db/db-common/affectedrows.xml:1.4 --- peardoc/fr/package/database/db/db-common/affectedrows.xml:1.3 Fri Feb 20 11:30:19 2004 +++ peardoc/fr/package/database/db/db-common/affectedrows.xml Tue Jul 6 17:11:26 2004 @@ -1,77 +1,114 @@ -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.10 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.23 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.affectedrows"> - <refnamediv> - <refname>DB_common::affectedRows()</refname> - <refpurpose>Trouve le nombre de lignes affectées</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>integer <function>affectedRows</function></funcdef> - <paramdef></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.affectedrows.desc"> - &title.desc; - <para> - Nombre de lignes affectées par la requête. Cette - fonction retourne 0 pour les requêtes du type SELECT. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.affectedrows.return"> - &title.returns; - <para> - <parameter>integer</parameter> - nombre de lignes ou - &class.db-error; en cas d'echec - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.affectedrows.throws"> - &title.throws; - <para> - <table> - <title>&title.throws.errortable;</title> - <tgroup cols="4"> - <thead> - <row> - <entry>Code erreur</entry> - <entry>Message erreur</entry> - <entry>Raison</entry> - <entry>Solution</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>DB_ERROR_NOT_CAPABLE</constant></entry> - <entry> - &null; - </entry> - <entry> - La fonction n'est pas supportée par le moteur de base de données - </entry> - <entry> - Changez de gestionnaire de base de données, si vous avez vraiment - besoin de cette fonctionnalité. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.affectedrows.note"> - &title.note; - ¬e.notstatic; - </refsect1> - <refsect1 id="package.database.db.db-common.affectedrows.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.query"> - <function>query</function></link> - </para> - </refsect1> - </refentry> + <refnamediv> + <refname>DB_common::affectedRows()</refname> + <refpurpose>Trouve le nombre de lignes affectées</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>integer <function>affectedRows</function></funcdef> + <paramdef></paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.affectedrows.desc"> + &title.desc; + <para> + Nombre de lignes affectées par une requête qui manipule des données + (par exemple <command>INSERT</command>, + <command>UPDATE</command> ou <command>DELETE</command>). + Cette fonction retourne 0 pour les requêtes du type <command>SELECT</command>. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.affectedrows.return"> + &title.returns; + <para> + &type.int; - nombre de lignes ou + &class.db-error; en cas d'echec + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.affectedrows.throws"> + &title.throws; + <para> + <table> + <title>&title.throws.errortable;</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Code erreur</entry> + <entry>Message erreur</entry> + <entry>Raison</entry> + <entry>Solution</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>DB_ERROR_NOT_CAPABLE</constant></entry> + <entry> + DB backend not capable + </entry> + <entry> + La fonction n'est pas supportée par le moteur de base de données + </entry> + <entry> + Changez de gestionnaire de base de données, si vous avez vraiment + besoin de cette fonctionnalité. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.affectedrows.note"> + &title.note; + ¬e.notstatic; + </refsect1> + + <refsect1 id="package.database.db.db-common.affectedrows.example"> + &title.example; + <example> + <title>Exemple avec <function>affectedRows</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// En supposant que vous avez un objet DB valide nommé $db... +$res =& $db->query('DELETE * FROM clients'); + +if (DB::isError($res)) { + die($res->getMessage()); +} + +echo 'J\'ai effacé ' . $db->affectedRows() . ' clients'; +?> +]]> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.affectedrows.see"> + &title.see; + <para> + <link linkend="package.database.db.db-common.query"> + <function>query</function></link>, + <link linkend="package.database.db.db-common.execute"> + <function>execute</function></link>, + <link linkend="package.database.db.db-common.autoexecute"> + <function>autoExecute</function></link>, + <link linkend="package.database.db.db-common.executemultiple"> + <function>executeMultiple</function></link> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/autoexecute.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/db-common/autoexecute.xml diff -u peardoc/fr/package/database/db/db-common/autoexecute.xml:1.2 peardoc/fr/package/database/db/db-common/autoexecute.xml:1.3 --- peardoc/fr/package/database/db/db-common/autoexecute.xml:1.2 Fri Feb 20 11:30:19 2004 +++ peardoc/fr/package/database/db/db-common/autoexecute.xml Tue Jul 6 17:11:26 2004 @@ -1,41 +1,52 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.15 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.31 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.autoexecute"> <refnamediv> <refname>DB_common::autoExecute()</refname> - <refpurpose>Exécuter automatiquement les requêtes d'insertion ou de mise à jour</refpurpose> + <refpurpose> + Prépare et éxécute automatiquement les requêtes INSERT ou UPDATE + basées sur les variables fournies + </refpurpose> </refnamediv> + <refsynopsisdiv> <funcsynopsis> <funcprototype> - <funcdef>DB_result <function>autoExecute</function></funcdef> - <paramdef>string <parameter>$table</parameter></paramdef> - <paramdef>array <parameter>$fields_values</parameter></paramdef> + <funcdef>integer <function>autoExecute</function></funcdef> + <paramdef> + string <parameter>$table</parameter> + </paramdef> + <paramdef> + array <parameter>$fields_values</parameter> + </paramdef> <paramdef> integer <parameter><optional>$mode = - <constant>DB_AUTOQUERY_INSERT</constant></optional></parameter> + <constant>DB_AUTOQUERY_INSERT</constant></optional></parameter> + </paramdef> + <paramdef> + string <parameter><optional>$where = &false;</optional></parameter> </paramdef> - <paramdef>string <parameter><optional>$where = &false;</optional></parameter></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> + <refsect1 id="package.database.db.db-common.autoexecute.desc"> &title.desc; <para> <function>autoExecute</function> construit automatiquement une requête - d'insertion ou de mise à jour puis invoque - <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> avec. - La requête est construite en utilisant + INSERT ou UPDATE. + </para> + <para> + Cette méthode construit des requêtes SQL en utilisant <link linkend="package.database.db.db-common.autoprepare"> - <function>autoPrepare</function></link>. - Pour appeler autoExecute, vous n'avez besoin que d'un tableau associatif - (clef => valeur) où les clefs sont les noms des champs et les valeurs sont - les valeurs correspondantes à ces champs. + <function>autoPrepare</function></link> et les exécutent en utilisant + <link linkend="package.database.db.db-common.execute"> + <function>execute</function></link>. </para> </refsect1> + <refsect1 id="package.database.db.db-common.autoexecute.parameter"> &title.param; <para> @@ -58,7 +69,7 @@ </term> <listitem> <para> - tableau associatif (clef => valeur), les clefs sont les noms des champs + tableau associatif (clé => valeur), les clés sont les noms des champs et les valeurs sont les valeurs correspondantes à ces champs. </para> </listitem> @@ -83,8 +94,8 @@ </term> <listitem> <para> - in case of update queries, - this string will be put after the WHERE statement + dans le cas de requêtes de mise à jour, cette chaîne sera mise après la clause + <command>WHERE</command> </para> </listitem> </varlistentry> @@ -95,7 +106,7 @@ <refsect1 id="package.database.db.db-common.autoexecute.return"> &title.returns; <para> - <parameter>&class.db-result;</parameter> - un nouvel objet &class.db-result; + &type.int; - &constant.db-ok; en cas de succès ou un objet &class.db-error; en cas d'erreurs </para> </refsect1> @@ -117,24 +128,41 @@ <tbody> <row> <entry><constant>DB_ERROR_NEED_MORE_DATA</constant></entry> - <entry>&null;</entry> - <entry>Votre tableau associatif, qui doit contenir les noms des champs et leurs valeurs, est vide.</entry> - <entry>Vérifiez et corrigez votre tableau fields_values.</entry> + <entry> + insufficient data supplied + </entry> + <entry> + Votre tableau associatif, qui doit contenir les noms des champs + et leurs valeurs, est vide. + </entry> + <entry> + Vérifiez et corrigez votre tableau fields_values. + </entry> </row> <row> <entry><constant>DB_ERROR_SYNTAX</constant></entry> - <entry>&null;</entry> - <entry>Vous utilisez un mode inconnu.</entry> <entry> - Les modes disponibles sont <constant>DB_AUTOQUERY_INSERT</constant> pour - les insertions et <constant>DB_AUTOQUERY_UPDATE</constant> pour les mises - à jour. + syntax error + </entry> + <entry> + Vous utilisez un mode inconnu. + </entry> + <entry> + Les modes disponibles sont uniquement + <constant>DB_AUTOQUERY_INSERT</constant> pour + les requêtes <command>INSERT</command> ou + <constant>DB_AUTOQUERY_UPDATE</constant> pour + les requêtes <command>UPDATE</command>. </entry> </row> <row> <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> - <entry>&null;</entry> - <entry>Aucune base de données n'a été sélectionnée.</entry> + <entry> + no database selected + </entry> + <entry> + Aucune base de données n'a été sélectionnée. + </entry> <entry> Vérifiez le <link linkend="package.database.db.intro-dsn">DSN</link> dans <link linkend="package.database.db.db.connect"> @@ -145,7 +173,7 @@ <entry>tout autre code erreur</entry> <entry></entry> <entry> - Erreur spécifique à la base de données. + Erreur spécifique à la base de données </entry> <entry> Vérifiez la section spécifique à la base de données dans le @@ -163,16 +191,43 @@ <refsect1 id="package.database.db.db-common.autoexecute.note"> &title.note; ¬e.notstatic; - <para> - Voyez <link linkend="package.database.db.intro-auto">Introduction - - autoPrepare et autoExecute</link> pour les utilisations et les exemples. - </para> </refsect1> + <refsect1 id="package.database.db.db-common.autoexecute.example"> + &title.example; + <example> + <title>Exemple avec <function>autoExecute</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// En supposant que vous avez un objet DB valide nommé $db... +$table_name = 'user'; + +$fields_values = array( + 'id' => 1, + 'name' => 'Fabien', + 'country' => 'France' +); + +$res = $db->autoExecute($table_name, $fields_values, + DB_AUTOQUERY_INSERT); + +if (DB::isError($res)) { + die($res->getMessage()); +} +?> + ]]> + </programlisting> + </example> + </refsect1> <refsect1 id="package.database.db.db-common.autoexecute.see"> &title.see; <para> + <link linkend="package.database.db.intro-execute"> + <quote>Intro - Prepare & Execute</quote></link>, + <link linkend="package.database.db.intro-auto"> + <quote>Intro - autoPrepare & autoExecute</quote></link>, <link linkend="package.database.db.db-common.prepare"> <function>prepare</function></link>, <link linkend="package.database.db.db-common.execute"> @@ -183,9 +238,8 @@ <function>autoPrepare</function></link> </para> </refsect1> - - </refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/autoprepare.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/fr/package/database/db/db-common/autoprepare.xml diff -u peardoc/fr/package/database/db/db-common/autoprepare.xml:1.1 peardoc/fr/package/database/db/db-common/autoprepare.xml:1.2 --- peardoc/fr/package/database/db/db-common/autoprepare.xml:1.1 Sat Feb 21 21:04:07 2004 +++ peardoc/fr/package/database/db/db-common/autoprepare.xml Tue Jul 6 17:11:26 2004 @@ -1,18 +1,33 @@ -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.14 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.31 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.autoprepare"> <refnamediv> <refname>DB_common::autoPrepare()</refname> - <refpurpose>Construit et exécute une requête automatiquement</refpurpose> + <refpurpose> + Prépare une requête INSERT ou UPDATE + basée sur les variables fournies + </refpurpose> </refnamediv> + <refsynopsisdiv> <funcsynopsis> <funcprototype> <funcdef>resource <function>autoPrepare</function></funcdef> - <paramdef>string <parameter>$table</parameter></paramdef> - <paramdef>array <parameter>$table_fields</parameter></paramdef> - <paramdef>integer <parameter>$mode = <constant>DB_AUTOQUERY_INSERT</constant></parameter></paramdef> - <paramdef>string <parameter><optional>$where = &false;</optional></parameter></paramdef> + <paramdef> + string <parameter>$table</parameter> + </paramdef> + <paramdef> + array <parameter>$table_fields</parameter> + </paramdef> + <paramdef> + integer <parameter>$mode = + <constant>DB_AUTOQUERY_INSERT</constant></parameter> + </paramdef> + <paramdef> + string <parameter><optional>$where = &false;</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> @@ -21,11 +36,12 @@ &title.desc; <para> <function>autoPrepare</function> construit automatiquement une requête - d'insertion ou de mise à jour et apelle - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> avec. - La requête SQL est construire en utilisant un tableau ordonné contenant les - nom des champs. + <command>INSERT</command> ou <command>UPDATE</command> pour être + utilisée par + <link linkend="package.database.db.db-common.execute"> + <function>execute</function></link> ou + <link linkend="package.database.db.db-common.executemultiple"> + <function>executeMultiple</function></link>. </para> </refsect1> @@ -36,7 +52,7 @@ <varlistentry> <term> &type.string; - <parameter>string $table</parameter> + <parameter>$table</parameter> </term> <listitem> <para> @@ -74,8 +90,8 @@ </term> <listitem> <para> - si la requête est une mise à jour, cette chaîne sera ajoutée après la - clause WHERE + si la requête est une mise à jour, cette chaîne + sera ajoutée après la clause WHERE </para> </listitem> </varlistentry> @@ -86,7 +102,8 @@ <refsect1 id="package.database.db.db-common.autoprepare.return"> &title.returns; <para> - <parameter>resource</parameter> - ressource utilisée pour la requête + &type.resource; - ressource utilisée pour la requête + ou un objet &class.db-error; en cas d'échec </para> </refsect1> @@ -107,7 +124,9 @@ <tbody> <row> <entry><constant>DB_ERROR_NEED_MORE_DATA</constant></entry> - <entry>&null;</entry> + <entry> + insufficient data supplied + </entry> <entry> Le tableau qui doit contenir les noms de champs est vide. </entry> @@ -117,18 +136,27 @@ </row> <row> <entry><constant>DB_ERROR_SYNTAX</constant></entry> - <entry>&null;</entry> + <entry> + syntax error + </entry> <entry>Vous utilisez un mode inconnu.</entry> <entry> - Les modes disponibles sont <constant>DB_AUTOQUERY_INSERT</constant> pour - les insertions et <constant>DB_AUTOQUERY_UPDATE</constant> pour les mises - à jour. + Les modes disponibles sont uniquement + <constant>DB_AUTOQUERY_INSERT</constant> pour + les requêtes <command>INSERT</command> ou + <constant>DB_AUTOQUERY_UPDATE</constant> pour + les requêtes <command>UPDATE</command>. </entry> </row> <row> <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> - <entry>&null;</entry> - <entry>Aucune base de données n'a été sélectionnée.</entry> + <entry> + no database selected + </entry> + <entry> + Aucune base de données + n'a été sélectionnée. + </entry> <entry> Vérifiez le <link linkend="package.database.db.intro-dsn">DSN</link> dans <link linkend="package.database.db.db.connect"> @@ -150,23 +178,53 @@ </tbody> </tgroup> </table> - </para> + </para> </refsect1> <refsect1 id="package.database.db.db-common.autoprepare.note"> &title.note; ¬e.notstatic; - <para> - Voyez <link linkend="package.database.db.intro-auto">Introduction - - autoPrepare et autoExecute</link> pour les utilisations et les exemples. - </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.autoprepare.example"> + &title.example; + <example> + <title>Exemple avec <function>autoPrepare</function></title> + <programlisting role="php"> + <![CDATA[ +<?php +// En supposant que vous avez un objet DB valide nommé $db... +$table_name = 'user'; +$table_fields = array('name', 'country'); +$table_values = array('Bob', 'USA'); + +$sth = $db->autoPrepare($table_name, $table_fields, + DB_AUTOQUERY_UPDATE, 'id = 1'); + +if (DB::isError($sth)) { + die($sth->getMessage()); +} + +$res =& $db->execute($sth, $table_values); + +if (DB::isError($res)) { + die($res->getMessage()); +} +?> + ]]> + </programlisting> + </example> </refsect1> <refsect1 id="package.database.db.db-common.autoprepare.see"> &title.see; <para> + <link linkend="package.database.db.intro-execute"> + <quote>Intro - Prepare & Execute</quote></link>, + <link linkend="package.database.db.intro-auto"> + <quote>Intro - autoPrepare & autoExecute</quote></link>, <link linkend="package.database.db.db-common.prepare"> <function>prepare</function></link>, <link linkend="package.database.db.db-common.execute"> @@ -177,8 +235,6 @@ <function>autoExecute</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/db-common/createsequence.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/db-common/createsequence.xml diff -u peardoc/fr/package/database/db/db-common/createsequence.xml:1.2 peardoc/fr/package/database/db/db-common/createsequence.xml:1.3 --- peardoc/fr/package/database/db/db-common/createsequence.xml:1.2 Fri Feb 20 11:30:19 2004 +++ peardoc/fr/package/database/db/db-common/createsequence.xml Tue Jul 6 17:11:26 2004 @@ -1,95 +1,129 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.9 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.18 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.createsequence"> - <refnamediv> - <refname>DB_common::createSequence()</refname> - <refpurpose>Créé une nouvelle séquence</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>integer <function>createSequence</function></funcdef> - <paramdef>string <parameter>$seq_name</parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.createsequence.desc"> - &title.desc; - <para> - Voyez <link - linkend="package.database.db.intro-sequences"><quote>Introduction - Séquences</quote></link> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.createsequence.parameter"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - &type.string; - <parameter>$seq_name</parameter> - </term> - <listitem> - <para> - nom de la nouvelle séquence à créer - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.createsequence.return"> - &title.returns; - <para> - <parameter>integer</parameter> - &constant.db-ok; - ou &class.db-error; en cas d'echec. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.createsequence.throws"> - &title.throws; - <para> - <table> - <title>&title.throws.errortable;</title> - <tgroup cols="4"> - <thead> - <row> - <entry>Code erreur</entry> - <entry>Message erreur</entry> - <entry>Raison</entry> - <entry>Solution</entry> - </row> - </thead> - <tbody> - <row> - <entry>tout code erreur</entry> - <entry></entry> - <entry> - Erreur spécifique à la base de données - </entry> - <entry> - Vérifiez le nom de la séquence. Si il est correct, il s'agit - probablement d'un bogue dans l'implémentation de la séquence. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.createsequence.note"> - &title.note; - ¬e.notstatic; - </refsect1> - <refsect1 id="package.database.db.db-common.createsequence.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.nextid"> - <function>DB::nextId</function></link>, - <link linkend="package.database.db.db-common.dropsequence"> - <function>DB::dropSequence</function></link> - </para> - </refsect1> - </refentry> + <refnamediv> + <refname>DB_common::createSequence()</refname> + <refpurpose>Créé une nouvelle séquence</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>integer <function>createSequence</function></funcdef> + <paramdef> + string <parameter>$seq_name</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.createsequence.desc"> + &title.desc; + <para> + Voyez <link + linkend="package.database.db.intro-sequences"><quote>Introduction - Séquences</quote></link> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.createsequence.parameter"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.string; + <parameter>$seq_name</parameter> + </term> + <listitem> + <para> + nom de la nouvelle séquence à créer + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.createsequence.return"> + &title.returns; + <para> + &type.int; - &constant.db-ok; + ou un objet &class.db-error; en cas d'echec. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.createsequence.throws"> + &title.throws; + <para> + <table> + <title>&title.throws.errortable;</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Code erreur</entry> + <entry>Message erreur</entry> + <entry>Raison</entry> + <entry>Solution</entry> + </row> + </thead> + <tbody> + <row> + <entry>every error code</entry> + <entry></entry> + <entry> + Erreur spécifique à la base de données + </entry> + <entry> + Vérifiez le nom de la séquence. S'il est correct, il s'agit + probablement d'un bogue dans l'implémentation de la séquence. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.createsequence.note"> + &title.note; + ¬e.notstatic; + </refsect1> + + <refsect1 id="package.database.db.db-common.createsequence.example"> + &title.example; + <example> + <title>Exemple avec <function>createSequence</function></title> + <programlisting role="php"> + <![CDATA[ +<?php +// En supposant que vous avez un objet DB valide nommé $db... +$tmp = $db->createSequence('mySequence'); + +if (DB::isError($tmp)) { + die($tmp->getMessage()); +} +?> + ]]> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.createsequence.see"> + &title.see; + <para> + <link + linkend="package.database.db.intro-sequences"><quote>Introduction - + Séquences</quote></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: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/disconnect.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/db-common/disconnect.xml diff -u peardoc/fr/package/database/db/db-common/disconnect.xml:1.2 peardoc/fr/package/database/db/db-common/disconnect.xml:1.3 --- peardoc/fr/package/database/db/db-common/disconnect.xml:1.2 Fri Feb 20 11:30:19 2004 +++ peardoc/fr/package/database/db/db-common/disconnect.xml Tue Jul 6 17:11:26 2004 @@ -1,44 +1,73 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.9 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.19 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.disconnect"> - <refnamediv> - <refname>DB_common::disconnect()</refname> - <refpurpose>Termine la connexion à la base de données</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>boolean <function>disconnect</function></funcdef> - <paramdef></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.disconnect.desc"> - &title.desc; - <para> - Termine la connexion à la base de données. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.disconnect.return"> - &title.returns; - <para> - <parameter>boolean</parameter> - &return.success; - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.disconnect.note"> - &title.note; - ¬e.notstatic; - </refsect1> - <refsect1 id="package.database.db.db-common.disconnect.see"> - &title.see; - <para> - <link linkend="package.database.db.db.connect"> - <function>DB::connect</function></link>, - <link linkend="package.database.db.intro-connect"> - <function>Tutorial - Connect</function></link> - </para> - </refsect1> - </refentry> + <refnamediv> + <refname>DB_common::disconnect()</refname> + <refpurpose>Termine la connexion à la base de données</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>disconnect</function></funcdef> + <paramdef></paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.disconnect.desc"> + &title.desc; + <para> + Termine la connexion à la base de données. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.disconnect.return"> + &title.returns; + <para> + &type.bool; - &return.success; + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.disconnect.note"> + &title.note; + ¬e.notstatic; + </refsect1> + + <refsect1 id="package.database.db.db-common.disconnect.example"> + &title.example; + <example> + <title>Exemple avec <function>disconnect</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +require_once 'DB.php'; + +$db =& DB::connect('pgsql://someuser:apasswd@localhost/thedb'); +if (DB::isError($db)) { + die($db->getMessage()); +} + +$db->disconnect(); +?> + ]]> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.disconnect.see"> + &title.see; + <para> + <link linkend="package.database.db.db.connect"> + <function>connexion</function></link>, + <link linkend="package.database.db.intro-connect"> + <quote>Introduction - Connexion</quote></link> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/dropsequence.xml?r1=1.1&r2=1.2&ty=u Index: peardoc/fr/package/database/db/db-common/dropsequence.xml diff -u peardoc/fr/package/database/db/db-common/dropsequence.xml:1.1 peardoc/fr/package/database/db/db-common/dropsequence.xml:1.2 --- peardoc/fr/package/database/db/db-common/dropsequence.xml:1.1 Sat Feb 21 21:04:07 2004 +++ peardoc/fr/package/database/db/db-common/dropsequence.xml Tue Jul 6 17:11:26 2004 @@ -1,101 +1,130 @@ -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.9 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.17 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.dropsequence"> - <refnamediv> - <refname>DB_common::dropSequence()</refname> - <refpurpose>Supprime une séquence</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>integer <function>dropSequence</function></funcdef> - <paramdef>string <parameter>$seqName</parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.dropsequence.desc"> - &title.desc; - <para> - Voyez <link - linkend="package.database.db.intro-sequences"><quote>Introduction - Séquences</quote></link> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.dropsequence.parameter"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - &type.string; - <parameter>$seqName</parameter> - </term> - <listitem> - <para> - nom de la séquence à supprimer - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.dropsequence.return"> - &title.returns; - <para> - <itemizedlist> + <refnamediv> + <refname>DB_common::dropSequence()</refname> + <refpurpose>Supprime une séquence</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>integer <function>dropSequence</function></funcdef> + <paramdef> + string <parameter>$seqName</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.dropsequence.desc"> + &title.desc; + <para> + Voyez <link + linkend="package.database.db.intro-sequences"><quote>Introduction - + Séquences</quote></link> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.dropsequence.parameter"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.string; + <parameter>$seqName</parameter> + </term> <listitem> <para> - <parameter>integer</parameter> - &constant.db-ok; - ou &class.db-error; en cas d'erreurs + nom de la séquence à supprimer </para> </listitem> - </itemizedlist> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.dropsequence.throws"> - &title.throws; - <para> - <table> - <title>&title.throws.errortable;</title> - <tgroup cols="4"> - <thead> - <row> - <entry>Code erreur</entry> - <entry>Message erreur</entry> - <entry>Raison</entry> - <entry>Solution</entry> - </row> - </thead> - <tbody> - <row> - <entry>tout code erreur</entry> - <entry></entry> - <entry> - Erreur spécifique à la base de données. - </entry> - <entry> - Vérifiez le nom de la séquence. Si il est correct, il s'agit - probablement d'un bogue dans l'implémentation de la séquence. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.dropsequence.note"> - &title.note; - ¬e.notstatic; - </refsect1> - <refsect1 id="package.database.db.db-common.dropsequence.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.createsequence"> - <function>DB_common::createSequence</function></link>, - <link linkend="package.database.db.db-common.nextid"> - <function>DB_common::nextId</function></link> - </para> - </refsect1> - </refentry> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.dropsequence.return"> + &title.returns; + <para> + &type.int; - &constant.db-ok; + ou un objet &class.db-error; en cas d'erreur + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.dropsequence.throws"> + &title.throws; + <para> + <table> + <title>&title.throws.errortable;</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Code erreur</entry> + <entry>Message erreur</entry> + <entry>Raison</entry> + <entry>Solution</entry> + </row> + </thead> + <tbody> + <row> + <entry>tout code erreur</entry> + <entry></entry> + <entry> + Erreur spécifique à la base de données. + </entry> + <entry> + Vérifiez le nom de la séquence. S'il est correct, il s'agit + probablement d'un bogue dans l'implémentation de la séquence. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.dropsequence.note"> + &title.note; + ¬e.notstatic; + </refsect1> + + <refsect1 id="package.database.db.db-common.dropsequence.example"> + &title.example; + <example> + <title>Exemple avec <function>dropSequence</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// En supposant que vous avez un objet DB valide nommé $db... +$tmp = $db->dropSequence('mySequence'); + +if (DB::isError($tmp)) { + die($tmp->getMessage()); +} +?> +]]> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.dropsequence.see"> + &title.see; + <para> + <link + linkend="package.database.db.intro-sequences"><quote>Intro - + Sequences</quote></link>, + <link linkend="package.database.db.db-common.createsequence"> + <function>createSequence</function></link>, + <link linkend="package.database.db.db-common.nextid"> + <function>nextId</function></link> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/escapesimple.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/db-common/escapesimple.xml diff -u peardoc/fr/package/database/db/db-common/escapesimple.xml:1.2 peardoc/fr/package/database/db/db-common/escapesimple.xml:1.3 --- peardoc/fr/package/database/db/db-common/escapesimple.xml:1.2 Fri Feb 20 11:30:19 2004 +++ peardoc/fr/package/database/db/db-common/escapesimple.xml Tue Jul 6 17:11:26 2004 @@ -1,61 +1,71 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.17 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.escapesimple"> - <refnamediv> - <refname>DB_common::escapeSimple()</refname> - <refpurpose>Protège une chaîne en accord avec les standards du gestionnaire utilisé</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>escapeSimple</function></funcdef> - <paramdef>string <parameter>$str</parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.escapesimple.desc"> - &title.desc; - <para> - Protège une chaîne en accord avec les standards du gestionnaire utilisé. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.escapesimple.parameter"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - &type.string; - <parameter>$str</parameter> - </term> - <listitem> - <para> - la chaîne à protéger - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.escapesimple.return"> - &title.returns; - <para> - <parameter>string</parameter> - la chaîne protégée - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.escapesimple.note"> - &title.note; - ¬e.notstatic; - <simpara> - Fonction disponible depuis la version 1.6.0 - </simpara> - </refsect1> - <refsect1 id="package.database.db.db-common.escapesimple.example"> - &title.example; - <example> - <title>Utilisation de <function>escapeSimple</function></title> - <programlisting role="php"> - <![CDATA[ + <refnamediv> + <refname>DB_common::escapeSimple()</refname> + <refpurpose>Protège une chaîne en accord avec les standards du gestionnaire utilisé</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>escapeSimple</function></funcdef> + <paramdef> + string <parameter>$str</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.escapesimple.desc"> + &title.desc; + <para> + Protège une chaîne en accord avec les standards du gestionnaire utilisé. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.escapesimple.parameter"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.string; + <parameter>$str</parameter> + </term> + <listitem> + <para> + la chaîne à protéger + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.escapesimple.return"> + &title.returns; + <para> + &type.string; - la chaîne protégée + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.escapesimple.note"> + &title.note; + ¬e.notstatic; + <simpara> + Fonction disponible depuis la version 1.6.0 + </simpara> + </refsect1> + + <refsect1 id="package.database.db.db-common.escapesimple.example"> + &title.example; + <example> + <title>Utilisation de <function>escapeSimple</function></title> + <programlisting role="php"> +<![CDATA[ <?php // On suppose que $db est un objet DB valide... $name = "all's well"; @@ -65,17 +75,21 @@ $result =& $db->query($sql); ?> ]]> - </programlisting> - </example> - </refsect1> - <refsect1 id="package.database.db.db-common.escapesimple.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.quotesmart"> - <function>quoteSmart</function></link> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.escapesimple.see"> + &title.see; + <para> + <link linkend="package.database.db.db-common.quoteidentifier"> + <function>quoteIdentifier</function></link>, + <link linkend="package.database.db.db-common.quotesmart"> + <function>quoteSmart</function></link> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/executemultiple.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/db-common/executemultiple.xml diff -u peardoc/fr/package/database/db/db-common/executemultiple.xml:1.2 peardoc/fr/package/database/db/db-common/executemultiple.xml:1.3 --- peardoc/fr/package/database/db/db-common/executemultiple.xml:1.2 Mon Feb 23 18:09:20 2004 +++ peardoc/fr/package/database/db/db-common/executemultiple.xml Tue Jul 6 17:11:26 2004 @@ -1,177 +1,230 @@ -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.12 Maintainer: didou Status: ready --> +<?xml version="1.0" encoding="iso-8859-1" ?> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.28 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.executemultiple"> - <refnamediv> - <refname>DB_common::executeMultiple()</refname> - <refpurpose>Exécute plusieurs fois une requête SQL préparée</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>executeMultiple</function></funcdef> - <paramdef>resource <parameter>$stmt</parameter></paramdef> - <paramdef>array <parameter>$data</parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.executemultiple.desc"> - &title.desc; - <para> - <function>executeMultiple</function> remplit la requête SQL préparée avec - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> avec les données fournies puis - exécute la requête pour chaque <quote>ligne</quote> du tableau - <parameter>$data</parameter>. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.executemultiple.parameter"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - &type.res; - <parameter>$stmt</parameter> - </term> - <listitem> - <para> - identifiant de ressource de requête retourné par - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - &type.array; - <parameter>array $data</parameter> - </term> - <listitem> - <para> - un tableau numérique contenant les données à insérer dans la requête - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.executemultiple.return"> - &title.returns; - <para> - <parameter>mixed</parameter> - un nouveau &class.db-result;/&constant.db-ok; - ou un &class.db-error; en cas d'echec - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.executemultiple.throws"> - &title.throws; - <para> - <table> - <title>&title.throws.errortable;</title> - <tgroup cols="4"> - <thead> - <row> - <entry>Code erreur</entry> - <entry>Message erreur</entry> - <entry>Raison</entry> - <entry>Solution</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>DB_ERROR_INVALID</constant></entry> - <entry> - &null; - </entry> - <entry> - SQL statment handle is not valid. - </entry> - <entry> - Vérifiez que la requête fonctionne bien avec - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>. Notez que - <function>executeMultiple</function> requière une - ressource de requête retournée par <link - linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>, - et non pas la requête elle-même. - </entry> - </row> - <row> - <entry><constant>DB_ERROR_MISMATCH</constant></entry> - <entry> - &null; - </entry> - <entry> - Pas assez de données pour préparer la requête - SQL. - </entry> - <entry> - Vérifiez le nombre de marqueurs dans la requête - <link linkend="package.database.db.db-common.prepare"> - passée à <function>prepare</function></link>. - Vérifiez le nombre d'éléments du tableau - <parameter>$data</parameter>. Il doit être égal au nombre - de marqueurs. - </entry> - </row> - <row> - <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> - <entry> - &null; - </entry> - <entry> - Aucune base de données n'a été sélectionnée. - </entry> - <entry> - Vérifiez le <link linkend="package.database.db.intro-dsn">DSN</link> - dans <link linkend="package.database.db.db.connect"> - <function>connect</function></link>. - </entry> - </row> - <row> - <entry>tout autre code erreur</entry> - <entry></entry> - <entry> - Erreur spécifique à la base de données. - </entry> - <entry> - Vérifiez la section spécifique à la base de données dans le - <ulink url="www.php.net/manual/">manuel PHP</ulink> - pour trouver la raison de cette erreur. Dans la plupart des cas, il - s'agit d'une requête mal formée. Comme l'utilisation de LIMIT dans - une requête envoyée à une base de données Oracle. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.executemultiple.note"> - &title.note; - ¬e.notstatic; - <warning> - <para> - Si une erreur se produit durant l'exécution, la fonction s'arretera. Il - se peut qu'il reste alors des données non traitées. - </para> - </warning> - <para> - Voyez <link linkend="package.database.db.intro-execute"> - Introduction - Execute</link> pour un cas d'utilisation général et un - exemple. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.executemultiple.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>, - <link linkend="package.database.db.db-common.execute"> - <function>execute</function></link> - </para> - </refsect1> - </refentry> + <refnamediv> + <refname>DB_common::executeMultiple()</refname> + <refpurpose>Exécute une requête préparée SQL pour chaque élément d'un tableau</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>executeMultiple</function></funcdef> + <paramdef> + resource <parameter>$stmt</parameter> + </paramdef> + <paramdef> + array <parameter>$data</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.executemultiple.desc"> + &title.desc; + <para> + Passe automatiquement les informations contenues dans + <parameter>$data</parameter> (un tableau multi-dimentionnel) à + <link linkend="package.database.db.db-common.execute"> + <function>execute</function></link>, qui exécute la requête soumise à + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.executemultiple.parameter"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.res; + <parameter>$stmt</parameter> + </term> + <listitem> + <para> + identifiant de ressource de requête retourné par + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + &type.array; + <parameter>$data</parameter> + </term> + <listitem> + <para> + un tableau numérique contenant les données + à insérer dans la requête + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.executemultiple.return"> + &title.returns; + <para> + &type.mixed; - 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> + </refsect1> + + <refsect1 id="package.database.db.db-common.executemultiple.throws"> + &title.throws; + <para> + <table> + <title>&title.throws.errortable;</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Code erreur</entry> + <entry>Message erreur</entry> + <entry>Raison</entry> + <entry>Solution</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>DB_ERROR_INVALID</constant></entry> + <entry> + invalid + </entry> + <entry> + la ressource de la requête SQL n'est pas valide. + </entry> + <entry> + Vérifiez que la requête fonctionne bien avec + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>. Notez que + <function>executeMultiple</function> requière une + ressource de requête retournée par <link + linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>, + et non pas la requête elle-même. + </entry> + </row> + <row> + <entry><constant>DB_ERROR_MISMATCH</constant></entry> + <entry> + mismatch + </entry> + <entry> + Pas assez de données pour préparer la requête + SQL. + </entry> + <entry> + Vérifiez que le nombre de marqueurs dans la requête + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link> passée à + <parameter>$query</parameter> est égal au nombre d'entrées + passées par <parameter>$params</parameter>. + </entry> + </row> + <row> + <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> + <entry> + no database selected + </entry> + <entry> + Aucune base de données n'a été sélectionnée. + </entry> + <entry> + Vérifiez le <link linkend="package.database.db.intro-dsn">DSN</link> + dans <link linkend="package.database.db.db.connect"> + <function>connect</function></link>. + </entry> + </row> + <row> + <entry>tout autre code erreur</entry> + <entry></entry> + <entry> + Erreur spécifique à la base de données. + </entry> + <entry> + Vérifiez la section spécifique à la base de données dans le + <ulink url="www.php.net/manual/">manuel PHP</ulink> + pour trouver la raison de cette erreur. Dans la plupart des cas, il + s'agit d'une requête mal formée, comme l'utilisation de LIMIT dans + une requête envoyée à une base de données Oracle. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.executemultiple.note"> + &title.note; + ¬e.notstatic; + <warning> + <para> + Si une erreur se produit durant l'exécution, la fonction s'arretera. Il + se peut qu'il reste alors des données non traitées. + </para> + </warning> + </refsect1> + + <refsect1 id="package.database.db.db-common.executemultiple.example"> + &title.example; + <example> + <title>Exemple avec <function>executeMultiple</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// On suppose que $db est un objet DB valide... +$sth = $db->prepare('INSERT INTO numbers VALUES (?, ?, ?)'); + +if (DB::isError($sth)) { + die($sth->getMessage()); +} + +$alldata = array(array(1, 'one', 'en'), + array(2, 'two', 'to'), + array(3, 'three', 'tre'), + array(4, 'four', 'fire')); + +$res =& $db->executeMultiple($sth, $alldata); + +if (DB::isError($res)) { + die($res->getMessage()); +} +?> +]]> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.executemultiple.see"> + &title.see; + <para> + <link linkend="package.database.db.intro-execute"> + <quote>Introduction - Préparation & Exécution</quote></link>, + <link linkend="package.database.db.intro-auto"> + <quote>Introduction - autoPrepare & autoExecute</quote></link>, + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>, + <link linkend="package.database.db.db-common.execute"> + <function>execute</function></link>, + <link linkend="package.database.db.db-common.autoprepare"> + <function>autoPrepare</function></link>, + <link linkend="package.database.db.db-common.autoexecute"> + <function>autoExecute</function></link> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/peardoc/fr/package/database/db/db-common/execute.xml?r1=1.2&r2=1.3&ty=u Index: peardoc/fr/package/database/db/db-common/execute.xml diff -u peardoc/fr/package/database/db/db-common/execute.xml:1.2 peardoc/fr/package/database/db/db-common/execute.xml:1.3 --- peardoc/fr/package/database/db/db-common/execute.xml:1.2 Mon Feb 23 18:09:20 2004 +++ peardoc/fr/package/database/db/db-common/execute.xml Tue Jul 6 17:11:26 2004 @@ -1,168 +1,228 @@ -<!-- $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.29 Maintainer: didou Status: ready --> + <refentry id="package.database.db.db-common.execute"> - <refnamediv> - <refname>DB_common::execute()</refname> - <refpurpose>Exécute une requête SQL préparée</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>object <function>&execute</function></funcdef> - <paramdef>resource <parameter>$stmt</parameter></paramdef> - <paramdef>array <parameter>$data</parameter></paramdef> - </funcprototype> - </funcsynopsis> - </refsynopsisdiv> - <refsect1 id="package.database.db.db-common.execute.desc"> - &title.desc; - <para> - <function>execute</function> remplis la requête SQL préparée par - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> avec les données fournies puis - exécute la requête. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.execute.parameter"> - &title.param; - <para> - <variablelist> - <varlistentry> - <term> - &type.res; - <parameter>$stmt</parameter> - </term> - <listitem> - <para> - ressource de requête retournée par - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function> - </link> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> - &type.array; - <parameter>array $data</parameter> - </term> - <listitem> - <para> - un tableau numérique contenant les données à insérer dans la requête - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.execute.return"> - &title.returns; - <para> - <parameter>mixed</parameter> - un nouveau &class.db-result;/&constant.db-ok; - ou un &class.db-error; en cas d'erreurs - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.execute.throws"> - &title.throws; - <para> - <table> - <title>&title.throws.errortable;</title> - <tgroup cols="4"> - <thead> - <row> - <entry>Code erreur</entry> - <entry>Message erreur</entry> - <entry>Raison</entry> - <entry>Solution</entry> - </row> - </thead> - <tbody> - <row> - <entry><constant>DB_ERROR_INVALID</constant></entry> - <entry> - &null; - </entry> - <entry> - la ressource de requête SQL n'est pas valide - </entry> - <entry> - Vérifiez que la requête fonctionne bien avec - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>. Notez que - <function>execute</function> requière une ressource de requête - retournée par <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>, et non pas la requête - elle-même. - </entry> - </row> - <row> - <entry><constant>DB_ERROR_MISMATCH</constant></entry> - <entry> - &null; - </entry> - <entry> - Pas assez de données pour préparer la requête SQL. - </entry> - <entry> - Vérifiez le nombre de marqueurs dans la requête - <link linkend="package.database.db.db-common.prepare"> passée à - <function>prepare</function></link>. Vérifiez le nombre d'éléments - du tableau <parameter>$data</parameter>. Il doit être égal au nombre - de marqueurs. - </entry> - </row> - <row> - <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> - <entry> - &null; - </entry> - <entry> - Aucune base de données n'a été sélectionnée. - </entry> - <entry> - Vérifiez le <link linkend="package.database.db.intro-dsn">DSN</link> - dans <link linkend="package.database.db.db.connect"> - <function>connect</function></link>. - </entry> - </row> - <row> - <entry>tout autre code erreur</entry> - <entry></entry> - <entry> - Erreur spécifique à la base de données. - </entry> - <entry> - Vérifiez la section spécifique à la base de données dans le - <ulink url="www.php.net/manual/">manuel PHP</ulink> - pour trouver la raison de cette erreur. Dans la plupart des cas, il - s'agit d'une requête mal formée. Comme l'utilisation de LIMIT dans - une requête envoyée à une base de données Oracle. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.execute.note"> - &title.note; - ¬e.notstatic; - <para> - Voyez <link linkend="package.database.db.intro-execute"> - Introduction - Execute</link> pour les cas d'utilisation générale et un - exemple. - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.execute.see"> - &title.see; - <para> - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>, - <link linkend="package.database.db.db-common.executemultiple"> - <function>executeMultiple</function></link> - </para> - </refsect1> - </refentry> + <refnamediv> + <refname>DB_common::execute()</refname> + <refpurpose>Exécute une requête SQL préparée</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>&execute</function></funcdef> + <paramdef> + resource <parameter>$stmt</parameter> + </paramdef> + <paramdef> + mixed <parameter><optional>$data = array()</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + </refsynopsisdiv> + + <refsect1 id="package.database.db.db-common.execute.desc"> + &title.desc; + <para> + <function>execute</function> remplis la requête SQL préparée par + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link> avec les données fournies par + <parameter>$data</parameter> puis + exécute la requête. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.parameter"> + &title.param; + <para> + <variablelist> + <varlistentry> + <term> + &type.res; + <parameter>$stmt</parameter> + </term> + <listitem> + <para> + ressource de requête retournée par + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function> + </link> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + &type.mixed; + <parameter>$data</parameter> + </term> + <listitem> + <para> + tableau, chaîne de caractères ou donnée numérique contenant + les données à insérer dans la requête. + Le nombre d'éléments passées doit correspondre au nombre de marqueurs + de la requête préparée : 1 marqueur par paramètres (sauf tableau) ou + 1 marqueur par élément de tableau. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.return"> + &title.returns; + <para> + &type.mixed; - 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'échec. + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.throws"> + &title.throws; + <para> + <table> + <title>&title.throws.errortable;</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Code erreur</entry> + <entry>Message erreur</entry> + <entry>Raison</entry> + <entry>Solution</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>DB_ERROR_INVALID</constant></entry> + <entry> + invalid + </entry> + <entry> + la ressource de requête SQL n'est pas valide + </entry> + <entry> + Vérifiez que la requête fonctionne bien avec + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>. Notez que + <function>execute</function> requière une ressource de requête + retournée par <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>, et non pas la requête + elle-même. + </entry> + </row> + <row> + <entry><constant>DB_ERROR_MISMATCH</constant></entry> + <entry> + mismatch + </entry> + <entry> + Pas assez de données pour préparer la requête SQL. + </entry> + <entry> + Vérifiez que le nombre de marqueurs dans la requête + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link> passée à + <parameter>$query</parameter> correspond au nombre d'entrées passées à + <parameter>$params</parameter>. + </entry> + </row> + <row> + <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> + <entry> + no database selected + </entry> + <entry> + Aucune base de données n'a été sélectionnée. + </entry> + <entry> + Vérifiez le <link linkend="package.database.db.intro-dsn">DSN</link> + dans <link linkend="package.database.db.db.connect"> + <function>connect</function></link>. + </entry> + </row> + <row> + <entry>tout autre code erreur</entry> + <entry></entry> + <entry> + Erreur spécifique à la base de données. + </entry> + <entry> + Vérifiez la section spécifique à la base de données dans le + <ulink url="www.php.net/manual/">manuel PHP</ulink> + pour trouver la raison de cette erreur. Dans la plupart des cas, il + s'agit d'une requête mal formée, comme l'utilisation de LIMIT dans + une requête envoyée à une base de données Oracle. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.note"> + &title.note; + ¬e.notstatic; + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.example"> + &title.example; + <example> + <title>Exemple en passant un scalaire à <function>execute</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// On suppose que $db est un objet DB valide... +$sth = $db->prepare('INSERT INTO numbers (number) VALUES (?)'); +if (DB::isError($sth)) { + die($sth->getMessage()); +} + +$res =& $db->execute($sth, 1); +if (DB::isError($res)) { + die($res->getMessage()); +} +?> +]]> + </programlisting> + </example> + + <example> + <title>Exemple en passant un tableau à <function>execute</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +// On suppose que $db est un objet DB valide... +$sth = $db->prepare('INSERT INTO numbers VALUES (?, ?, ?)'); + +$data = array(1, 'one', 'en'); +$db->execute($sth, $data); +?> +]]> + </programlisting> + </example> + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.see"> + &title.see; + <para> + <link linkend="package.database.db.intro-execute"> + <quote>Introduction - Préparation & Exécution</quote></link>, + <link linkend="package.database.db.intro-auto"> + <quote>Intro - autoPrepare & autoExecute</quote></link>, + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>, + <link linkend="package.database.db.db-common.executemultiple"> + <function>executeMultiple</function></link> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml