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: 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&eacute;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&eacute;es par la requ&ecirc;te. Cette - fonction retourne 0 pour les requ&ecirc;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&eacute;e par le moteur de base de donn&eacute;es - </entry> - <entry> - Changez de gestionnaire de base de donn&eacute;es, si vous avez vraiment - besoin de cette fonctionnalit&eacute;. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.affectedrows.note"> - &title.note; - &note.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&eacute;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&eacute;es par une requ&ecirc;te qui manipule des donn&eacute;es + (par exemple <command>INSERT</command>, + <command>UPDATE</command> ou <command>DELETE</command>). + Cette fonction retourne 0 pour les requ&ecirc;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&eacute;e par le moteur de base de donn&eacute;es + </entry> + <entry> + Changez de gestionnaire de base de donn&eacute;es, si vous avez vraiment + besoin de cette fonctionnalit&eacute;. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.affectedrows.note"> + &title.note; + &note.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&eacute; $db... +$res =& $db->query('DELETE * FROM clients'); + +if (DB::isError($res)) { + die($res->getMessage()); +} + +echo 'J\'ai effac&eacute; ' . $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&eacute;cuter automatiquement les requ&ecirc;tes d'insertion ou de mise &agrave; jour</refpurpose> + <refpurpose> + Pr&eacute;pare et &eacute;x&eacute;cute automatiquement les requ&ecirc;tes INSERT ou UPDATE + bas&eacute;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&ecirc;te - d'insertion ou de mise &agrave; 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&ecirc;te est construite en utilisant + INSERT ou UPDATE. + </para> + <para> + Cette m&eacute;thode construit des requ&ecirc;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 =&gt; valeur) o&ugrave; les clefs sont les noms des champs et les valeurs sont - les valeurs correspondantes &agrave; ces champs. + <function>autoPrepare</function></link> et les ex&eacute;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 =&gt; valeur), les clefs sont les noms des champs + tableau associatif (cl&eacute; =&gt; valeur), les cl&eacute;s sont les noms des champs et les valeurs sont les valeurs correspondantes &agrave; 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&ecirc;tes de mise &agrave; jour, cette cha&icirc;ne sera mise apr&egrave;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&egrave;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&eacute;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&eacute;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 - &agrave; 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&ecirc;tes <command>INSERT</command> ou + <constant>DB_AUTOQUERY_UPDATE</constant> pour + les requ&ecirc;tes <command>UPDATE</command>. </entry> </row> <row> <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> - <entry>&null;</entry> - <entry>Aucune base de donn&eacute;es n'a &eacute;t&eacute; s&eacute;lectionn&eacute;e.</entry> + <entry> + no database selected + </entry> + <entry> + Aucune base de donn&eacute;es n'a &eacute;t&eacute; s&eacute;lectionn&eacute;e. + </entry> <entry> V&eacute;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&eacute;cifique &agrave; la base de donn&eacute;es. + Erreur sp&eacute;cifique &agrave; la base de donn&eacute;es </entry> <entry> V&eacute;rifiez la section sp&eacute;cifique &agrave; la base de donn&eacute;es dans le @@ -163,16 +191,43 @@ <refsect1 id="package.database.db.db-common.autoexecute.note"> &title.note; &note.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&eacute; $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 &amp; Execute</quote></link>, + <link linkend="package.database.db.intro-auto"> + <quote>Intro - autoPrepare &amp; 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&eacute;cute une requ&ecirc;te automatiquement</refpurpose> + <refpurpose> + Pr&eacute;pare une requ&ecirc;te INSERT ou UPDATE + bas&eacute;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&ecirc;te - d'insertion ou de mise &agrave; jour et apelle - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> avec. - La requ&ecirc;te SQL est construire en utilisant un tableau ordonn&eacute; contenant les - nom des champs. + <command>INSERT</command> ou <command>UPDATE</command> pour &ecirc;tre + utilis&eacute;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&ecirc;te est une mise &agrave; jour, cette cha&icirc;ne sera ajout&eacute;e apr&egrave;s la - clause WHERE + si la requ&ecirc;te est une mise &agrave; jour, cette cha&icirc;ne + sera ajout&eacute;e apr&egrave;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&eacute;e pour la requ&ecirc;te + &type.resource; - ressource utilis&eacute;e pour la requ&ecirc;te + ou un objet &class.db-error; en cas d'&eacute;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 - &agrave; jour. + Les modes disponibles sont uniquement + <constant>DB_AUTOQUERY_INSERT</constant> pour + les requ&ecirc;tes <command>INSERT</command> ou + <constant>DB_AUTOQUERY_UPDATE</constant> pour + les requ&ecirc;tes <command>UPDATE</command>. </entry> </row> <row> <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> - <entry>&null;</entry> - <entry>Aucune base de donn&eacute;es n'a &eacute;t&eacute; s&eacute;lectionn&eacute;e.</entry> + <entry> + no database selected + </entry> + <entry> + Aucune base de donn&eacute;es + n'a &eacute;t&eacute; s&eacute;lectionn&eacute;e. + </entry> <entry> V&eacute;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; &note.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&eacute; $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 &amp; Execute</quote></link>, + <link linkend="package.database.db.intro-auto"> + <quote>Intro - autoPrepare &amp; 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&eacute;&eacute; une nouvelle s&eacute;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&eacute;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&eacute;quence &agrave; cr&eacute;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&eacute;cifique &agrave; la base de donn&eacute;es - </entry> - <entry> - V&eacute;rifiez le nom de la s&eacute;quence. Si il est correct, il s'agit - probablement d'un bogue dans l'impl&eacute;mentation de la s&eacute;quence. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.createsequence.note"> - &title.note; - &note.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&eacute;&eacute; une nouvelle s&eacute;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&eacute;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&eacute;quence &agrave; cr&eacute;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&eacute;cifique &agrave; la base de donn&eacute;es + </entry> + <entry> + V&eacute;rifiez le nom de la s&eacute;quence. S'il est correct, il s'agit + probablement d'un bogue dans l'impl&eacute;mentation de la s&eacute;quence. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.createsequence.note"> + &title.note; + &note.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&eacute; $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&eacute;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 &agrave; la base de donn&eacute;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 &agrave; la base de donn&eacute;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; - &note.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 &agrave; la base de donn&eacute;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 &agrave; la base de donn&eacute;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; + &note.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&eacute;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&eacute;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&eacute;quence &agrave; 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&eacute;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&eacute;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&eacute;quence &agrave; 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&eacute;cifique &agrave; la base de donn&eacute;es. - </entry> - <entry> - V&eacute;rifiez le nom de la s&eacute;quence. Si il est correct, il s'agit - probablement d'un bogue dans l'impl&eacute;mentation de la s&eacute;quence. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.dropsequence.note"> - &title.note; - &note.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&eacute;cifique &agrave; la base de donn&eacute;es. + </entry> + <entry> + V&eacute;rifiez le nom de la s&eacute;quence. S'il est correct, il s'agit + probablement d'un bogue dans l'impl&eacute;mentation de la s&eacute;quence. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.dropsequence.note"> + &title.note; + &note.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&eacute; $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&egrave;ge une cha&icirc;ne en accord avec les standards du gestionnaire utilis&eacute;</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&egrave;ge une cha&icirc;ne en accord avec les standards du gestionnaire utilis&eacute;. - </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&icirc;ne &agrave; prot&eacute;ger - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.escapesimple.return"> - &title.returns; - <para> - <parameter>string</parameter> - la cha&icirc;ne prot&eacute;g&eacute;e - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.escapesimple.note"> - &title.note; - &note.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&egrave;ge une cha&icirc;ne en accord avec les standards du gestionnaire utilis&eacute;</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&egrave;ge une cha&icirc;ne en accord avec les standards du gestionnaire utilis&eacute;. + </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&icirc;ne &agrave; prot&eacute;ger + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.escapesimple.return"> + &title.returns; + <para> + &type.string; - la cha&icirc;ne prot&eacute;g&eacute;e + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.escapesimple.note"> + &title.note; + &note.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&eacute;cute plusieurs fois une requ&ecirc;te SQL pr&eacute;par&eacute;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&ecirc;te SQL pr&eacute;par&eacute;e avec - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> avec les donn&eacute;es fournies puis - ex&eacute;cute la requ&ecirc;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&ecirc;te retourn&eacute; 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&eacute;rique contenant les donn&eacute;es &agrave; ins&eacute;rer dans la requ&ecirc;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&eacute;rifiez que la requ&ecirc;te fonctionne bien avec - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>. Notez que - <function>executeMultiple</function> requi&egrave;re une - ressource de requ&ecirc;te retourn&eacute;e par <link - linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>, - et non pas la requ&ecirc;te elle-m&ecirc;me. - </entry> - </row> - <row> - <entry><constant>DB_ERROR_MISMATCH</constant></entry> - <entry> - &null; - </entry> - <entry> - Pas assez de donn&eacute;es pour pr&eacute;parer la requ&ecirc;te - SQL. - </entry> - <entry> - V&eacute;rifiez le nombre de marqueurs dans la requ&ecirc;te - <link linkend="package.database.db.db-common.prepare"> - pass&eacute;e &agrave; <function>prepare</function></link>. - V&eacute;rifiez le nombre d'&eacute;l&eacute;ments du tableau - <parameter>$data</parameter>. Il doit &ecirc;tre &eacute;gal au nombre - de marqueurs. - </entry> - </row> - <row> - <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> - <entry> - &null; - </entry> - <entry> - Aucune base de donn&eacute;es n'a &eacute;t&eacute; s&eacute;lectionn&eacute;e. - </entry> - <entry> - V&eacute;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&eacute;cifique &agrave; la base de donn&eacute;es. - </entry> - <entry> - V&eacute;rifiez la section sp&eacute;cifique &agrave; la base de donn&eacute;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&ecirc;te mal form&eacute;e. Comme l'utilisation de LIMIT dans - une requ&ecirc;te envoy&eacute;e &agrave; une base de donn&eacute;es Oracle. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.executemultiple.note"> - &title.note; - &note.notstatic; - <warning> - <para> - Si une erreur se produit durant l'ex&eacute;cution, la fonction s'arretera. Il - se peut qu'il reste alors des donn&eacute;es non trait&eacute;es. - </para> - </warning> - <para> - Voyez <link linkend="package.database.db.intro-execute"> - Introduction - Execute</link> pour un cas d'utilisation g&eacute;n&eacute;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&eacute;cute une requ&ecirc;te pr&eacute;par&eacute;e SQL pour chaque &eacute;l&eacute;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) &agrave; + <link linkend="package.database.db.db-common.execute"> + <function>execute</function></link>, qui ex&eacute;cute la requ&ecirc;te soumise &agrave; + <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&ecirc;te retourn&eacute; 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&eacute;rique contenant les donn&eacute;es + &agrave; ins&eacute;rer dans la requ&ecirc;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&ecirc;tes qui retournent des r&eacute;sultats (comme + les requ&ecirc;tes <command>SELECT</command>), + &constant.db-ok; + pour les requ&ecirc;tes qui manipulent des donn&eacute;es (comme + les requ&ecirc;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&ecirc;te SQL n'est pas valide. + </entry> + <entry> + V&eacute;rifiez que la requ&ecirc;te fonctionne bien avec + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>. Notez que + <function>executeMultiple</function> requi&egrave;re une + ressource de requ&ecirc;te retourn&eacute;e par <link + linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>, + et non pas la requ&ecirc;te elle-m&ecirc;me. + </entry> + </row> + <row> + <entry><constant>DB_ERROR_MISMATCH</constant></entry> + <entry> + mismatch + </entry> + <entry> + Pas assez de donn&eacute;es pour pr&eacute;parer la requ&ecirc;te + SQL. + </entry> + <entry> + V&eacute;rifiez que le nombre de marqueurs dans la requ&ecirc;te + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link> pass&eacute;e &agrave; + <parameter>$query</parameter> est &eacute;gal au nombre d'entr&eacute;es + pass&eacute;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&eacute;es n'a &eacute;t&eacute; s&eacute;lectionn&eacute;e. + </entry> + <entry> + V&eacute;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&eacute;cifique &agrave; la base de donn&eacute;es. + </entry> + <entry> + V&eacute;rifiez la section sp&eacute;cifique &agrave; la base de donn&eacute;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&ecirc;te mal form&eacute;e, comme l'utilisation de LIMIT dans + une requ&ecirc;te envoy&eacute;e &agrave; une base de donn&eacute;es Oracle. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.executemultiple.note"> + &title.note; + &note.notstatic; + <warning> + <para> + Si une erreur se produit durant l'ex&eacute;cution, la fonction s'arretera. Il + se peut qu'il reste alors des donn&eacute;es non trait&eacute;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&eacute;paration &amp; Ex&eacute;cution</quote></link>, + <link linkend="package.database.db.intro-auto"> + <quote>Introduction - autoPrepare &amp; 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&eacute;cute une requ&ecirc;te SQL pr&eacute;par&eacute;e</refpurpose> - </refnamediv> - <refsynopsisdiv> - <funcsynopsis> - <funcprototype> - <funcdef>object <function>&amp;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&ecirc;te SQL pr&eacute;par&eacute;e par - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link> avec les donn&eacute;es fournies puis - ex&eacute;cute la requ&ecirc;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&ecirc;te retourn&eacute;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&eacute;rique contenant les donn&eacute;es &agrave; ins&eacute;rer dans la requ&ecirc;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&ecirc;te SQL n'est pas valide - </entry> - <entry> - V&eacute;rifiez que la requ&ecirc;te fonctionne bien avec - <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>. Notez que - <function>execute</function> requi&egrave;re une ressource de requ&ecirc;te - retourn&eacute;e par <link linkend="package.database.db.db-common.prepare"> - <function>prepare</function></link>, et non pas la requ&ecirc;te - elle-m&ecirc;me. - </entry> - </row> - <row> - <entry><constant>DB_ERROR_MISMATCH</constant></entry> - <entry> - &null; - </entry> - <entry> - Pas assez de donn&eacute;es pour pr&eacute;parer la requ&ecirc;te SQL. - </entry> - <entry> - V&eacute;rifiez le nombre de marqueurs dans la requ&ecirc;te - <link linkend="package.database.db.db-common.prepare"> pass&eacute;e &agrave; - <function>prepare</function></link>. V&eacute;rifiez le nombre d'&eacute;l&eacute;ments - du tableau <parameter>$data</parameter>. Il doit &ecirc;tre &eacute;gal au nombre - de marqueurs. - </entry> - </row> - <row> - <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> - <entry> - &null; - </entry> - <entry> - Aucune base de donn&eacute;es n'a &eacute;t&eacute; s&eacute;lectionn&eacute;e. - </entry> - <entry> - V&eacute;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&eacute;cifique &agrave; la base de donn&eacute;es. - </entry> - <entry> - V&eacute;rifiez la section sp&eacute;cifique &agrave; la base de donn&eacute;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&ecirc;te mal form&eacute;e. Comme l'utilisation de LIMIT dans - une requ&ecirc;te envoy&eacute;e &agrave; une base de donn&eacute;es Oracle. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1 id="package.database.db.db-common.execute.note"> - &title.note; - &note.notstatic; - <para> - Voyez <link linkend="package.database.db.intro-execute"> - Introduction - Execute</link> pour les cas d'utilisation g&eacute;n&eacute;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&eacute;cute une requ&ecirc;te SQL pr&eacute;par&eacute;e</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>&amp;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&ecirc;te SQL pr&eacute;par&eacute;e par + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link> avec les donn&eacute;es fournies par + <parameter>$data</parameter> puis + ex&eacute;cute la requ&ecirc;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&ecirc;te retourn&eacute;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&icirc;ne de caract&egrave;res ou donn&eacute;e num&eacute;rique contenant + les donn&eacute;es &agrave; ins&eacute;rer dans la requ&ecirc;te. + Le nombre d'&eacute;l&eacute;ments pass&eacute;es doit correspondre au nombre de marqueurs + de la requ&ecirc;te pr&eacute;par&eacute;e : 1 marqueur par param&egrave;tres (sauf tableau) ou + 1 marqueur par &eacute;l&eacute;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&ecirc;tes + qui retournent des r&eacute;sultats (comme les requ&ecirc;tes + <command>SELECT</command>), + &constant.db-ok; pour les requ&ecirc;tes qui manipulent des donn&eacute;es + (comme les requ&ecirc;tes <command>INSERT</command>) + ou un objet &class.db-error; en cas d'&eacute;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&ecirc;te SQL n'est pas valide + </entry> + <entry> + V&eacute;rifiez que la requ&ecirc;te fonctionne bien avec + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>. Notez que + <function>execute</function> requi&egrave;re une ressource de requ&ecirc;te + retourn&eacute;e par <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link>, et non pas la requ&ecirc;te + elle-m&ecirc;me. + </entry> + </row> + <row> + <entry><constant>DB_ERROR_MISMATCH</constant></entry> + <entry> + mismatch + </entry> + <entry> + Pas assez de donn&eacute;es pour pr&eacute;parer la requ&ecirc;te SQL. + </entry> + <entry> + V&eacute;rifiez que le nombre de marqueurs dans la requ&ecirc;te + <link linkend="package.database.db.db-common.prepare"> + <function>prepare</function></link> pass&eacute;e &agrave; + <parameter>$query</parameter> correspond au nombre d'entr&eacute;es pass&eacute;es &agrave; + <parameter>$params</parameter>. + </entry> + </row> + <row> + <entry><constant>DB_ERROR_NODBSELECTED</constant></entry> + <entry> + no database selected + </entry> + <entry> + Aucune base de donn&eacute;es n'a &eacute;t&eacute; s&eacute;lectionn&eacute;e. + </entry> + <entry> + V&eacute;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&eacute;cifique &agrave; la base de donn&eacute;es. + </entry> + <entry> + V&eacute;rifiez la section sp&eacute;cifique &agrave; la base de donn&eacute;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&ecirc;te mal form&eacute;e, comme l'utilisation de LIMIT dans + une requ&ecirc;te envoy&eacute;e &agrave; une base de donn&eacute;es Oracle. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.note"> + &title.note; + &note.notstatic; + </refsect1> + + <refsect1 id="package.database.db.db-common.execute.example"> + &title.example; + <example> + <title>Exemple en passant un scalaire &agrave; <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 &agrave; <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&eacute;paration &amp; Ex&eacute;cution</quote></link>, + <link linkend="package.database.db.intro-auto"> + <quote>Intro - autoPrepare &amp; 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
« previous php.pear.doc (#4571) next »