cvs: phpdoc-fr /reference/pdo/functions PDO-beginTransaction.xml PDO-commit.xml PDO-errorCode.xml PDO-errorInfo.xml PDO-exec.xml PDO-getAttribute.xml
PDO-lastInsertId.xml PDO-prepare.xml PDO-query.xml PDO-quote.xml PDO-rollBack.xml PDOStatement-bindColumn.xml PDOStatement-bindParam.xml
PDOStatement-bindValue.xml PDOStatement-closeCursor.xml PDOStatement-columnCount.xml PDOStatement-errorCode.xml PDOStatement-errorInfo.xml
PDOStatement-execute.xml PDOStatement-fetch.xml PDOStatement-fetchAll.xml PDOStatement-fetchColumn.xml PDOStatement-fetchObject.xml
PDOStatement-getAttribute.xml PDOStatement-getColumnMeta.xml PDOStatement-nextRowset.xml PDOStatement-rowCount.xml PDOStatement-setAttribute.xml
PDOStatement-setFetchMode.xml /reference/pdo/pdo begintransaction.xml commit.xml errorcode.xml errorinfo.xml exec.xml getattribute.xml
lastinsertid.xml prepare.xml query.xml quote.xml rollback.xml /reference/pdo/pdostatement bindcolumn.xml bindparam.xml bindvalue.xml closecu!
rsor.xml columncount.xml errorcode.xml errorinfo.xml execute.xml fetch.xml fetchall.xml fetchcolumn.xml fetchobject.xml getattribute.xml
getcolumnmeta.xml nextrowset.xml rowcount.xml setattribute.xml setfetchmode.xml
| From: | Jean-S�bastien Goupil | Date: | Wed, 25 Jun 2008 08:12:02 +0000 |
| Subject: | cvs: phpdoc-fr /reference/pdo/functions PDO-beginTransaction.xml PDO-commit.xml PDO-errorCode.xml PDO-errorInfo.xml PDO-exec.xml PDO-getAttribute.xml PDO-lastInsertId.xml PDO-prepare.xml PDO-query.xml PDO-quote.xml PDO-rollBack.xml PDOStatement-bindColumn.xml PDOStatement-bindParam.xml PDOStatement-bindValue.xml PDOStatement-closeCursor.xml PDOStatement-columnCount.xml PDOStatement-errorCode.xml PDOStatement-errorInfo.xml PDOStatement-execute.xml PDOStatement-fetch.xml PDOStatement-fetchAll.xml PDOStatement-fetchColumn.xml PDOStatement-fetchObject.xml PDOStatement-getAttribute.xml PDOStatement-getColumnMeta.xml PDOStatement-nextRowset.xml PDOStatement-rowCount.xml PDOStatement-setAttribute.xml PDOStatement-setFetchMode.xml /reference/pdo/pdo begintransaction.xml commit.xml errorcode.xml errorinfo.xml exec.xml getattribute.xml lastinsertid.xml prepare.xml query.xml quote.xml rollback.xml /reference/pdo/pdostatement bindcolumn.xml bindparam.xml bindvalue.xml closecu! rsor.xml columncount.xml errorcode.xml errorinfo.xml execute.xml fetch.xml fetchall.xml fetchcolumn.xml fetchobject.xml getattribute.xml getcolumnmeta.xml nextrowset.xml rowcount.xml setattribute.xml setfetchmode.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6084@lists.php.net to get a copy of this message | ||
jsgoupil Wed Jun 25 08:12:02 2008 UTC
Added files:
/phpdoc-fr/reference/pdo/pdo begintransaction.xml commit.xml
errorcode.xml errorinfo.xml exec.xml
getattribute.xml lastinsertid.xml
prepare.xml query.xml quote.xml
rollback.xml
/phpdoc-fr/reference/pdo/pdostatement bindcolumn.xml bindparam.xml
bindvalue.xml closecursor.xml
columncount.xml errorcode.xml
errorinfo.xml execute.xml
fetch.xml fetchall.xml
fetchcolumn.xml
fetchobject.xml
getattribute.xml
getcolumnmeta.xml
nextrowset.xml rowcount.xml
setattribute.xml
setfetchmode.xml
Removed files:
/phpdoc-fr/reference/pdo/functions PDO-beginTransaction.xml
PDO-commit.xml PDO-errorCode.xml
PDO-errorInfo.xml PDO-exec.xml
PDO-getAttribute.xml
PDO-lastInsertId.xml
PDO-prepare.xml PDO-query.xml
PDO-quote.xml PDO-rollBack.xml
PDOStatement-bindColumn.xml
PDOStatement-bindParam.xml
PDOStatement-bindValue.xml
PDOStatement-closeCursor.xml
PDOStatement-columnCount.xml
PDOStatement-errorCode.xml
PDOStatement-errorInfo.xml
PDOStatement-execute.xml
PDOStatement-fetch.xml
PDOStatement-fetchAll.xml
PDOStatement-fetchColumn.xml
PDOStatement-fetchObject.xml
PDOStatement-getAttribute.xml
PDOStatement-getColumnMeta.xml
PDOStatement-nextRowset.xml
PDOStatement-rowCount.xml
PDOStatement-setAttribute.xml
PDOStatement-setFetchMode.xml
Log:
Lowercase, rename, and move as per the new-oo-style
- functions/PDOStatement-*.xml to pdostatement/*.xml
- functions/PDO-*.xml to pdo/*.xml
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/begintransaction.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/begintransaction.xml +++ phpdoc-fr/reference/pdo/pdo/begintransaction.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-beginTransaction" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->beginTransaction()</refname> <refpurpose> Démarre une transaction </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>beginTransaction</methodname> <void/> </methodsynopsis> </classsynopsis> <para> <function>PDO::beginTransaction</function> désactive le mode <literal>autocommit</literal>. Lorsque l'autocommit est désactivé, les modifications faites sur la base de données via les instances des objets PDO ne sont pas appliquées tant que vous ne mettez pas fin à la transaction en appelant la fonction <xref linkend="function.PDO-commit" />. L'appel de <xref linkend="function.PDO-rollBack" /> annulera toutes les modifications faites à la base de données et remettra la connexion en mode autocommit. </para> <para> Quelques bases de données, dont MySQL, exécuteront automatiquement un COMMIT lorsqu'une requête de définition de langage de base de données (DDL) comme DROP TABLE ou CREATE TABLE est exécutée dans une transaction. Ce COMMIT implicite vous empêchera d'annuler toutes autres modifications faites dans cette transaction. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Annule une transaction</title> <para> L'exemple suivant commence une transaction et exécute deux requêtes qui modifient la base de données avant d'annuler les modifications. Sur MySQL, cependant, la requête DROP TABLE validera automatiquement la transaction, donc, aucune des modifications de la transaction ne sera annulée. </para> <programlisting role='php'> <![CDATA[ <?php /* Démarre une transaction, désactivation de l'auto-commit */ $dbh->beginTransaction(); /* Modification du schéma de la base ainsi que des données */ $sth = $dbh->exec("DROP TABLE fruit"); $sth = $dbh->exec("UPDATE dessert SET name = 'hamburger'"); /* On s'aperçoit d'une erreur et on annule les modifications */ $dbh->rollBack(); /* Le connexion à la base de données est maintenant de retour en mode auto-commit */ ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-commit" /></member> <member><xref linkend="function.PDO-rollBack" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/commit.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/commit.xml +++ phpdoc-fr/reference/pdo/pdo/commit.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-commit" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->commit()</refname> <refpurpose> Valide une transaction </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>commit</methodname> <void/> </methodsynopsis> </classsynopsis> <para> <function>PDO::commit</function> valide une transaction, remet la connexion en mode <literal>autocommit</literal> en attendant l'appel à la fonction <xref linkend="function.PDO-beginTransaction" /> pour débuter une nouvelle transaction. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Valide une transaction</title> <programlisting role='php'> <![CDATA[ <?php /* Commence une transaction, désactivation de l'auto-commit */ $dbh->beginTransaction(); /* Modification du schéma de la base de données */ $sth = $dbh->exec("DROP TABLE fruit"); /* Valide les modifications */ $dbh->commit(); /* La connexion à la base de données est maintenant de retour en mode auto-commit */ ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-beginTransaction" /></member> <member><xref linkend="function.PDO-rollBack" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/errorcode.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/errorcode.xml +++ phpdoc-fr/reference/pdo/pdo/errorcode.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-errorCode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->errorCode()</refname> <refpurpose> Retourne le SQLSTATE associé avec la dernière opération sur la base de données </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>string</type><methodname>errorCode</methodname> <void/> </methodsynopsis> </classsynopsis> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDO-errorCode" /> retourne un SQLSTATE, un identifiant alphanumérique de cinq caractères défini dans le standard AINSI SQL. Brièvement, un SQLSTATE consiste en une valeur de classe de deux caractères suivi par une valeur de sous-classe de trois caractères. Une valeur de classe de 01 indique une alerte et est accompagnée par un code de retour SQL_SUCCESS_WITH_INFO. Les valeurs de classes autre que '01', mis à part la classe 'IM', indiquent une erreur. La classe 'IM' est spécifique aux alertes et aux erreurs qui sont issus de l'implémentation elle-même de PDO (ou peut-être ODBC, si vous utilisez le driver ODBC). La valeur de sous-classe '000' dans n'importe quelle classe, indique qu'il n'y a pas de sous-classe pour cet SQLSTATE. </para> <para> <xref linkend="function.PDO-errorCode" /> retourne uniquement les codes erreurs pour les opérations exécutées directement sur le gestionnaire de la base de données. Si vous créez un objet PDOStatement avec la fonction <xref linkend="function.PDO-prepare" /> ou la fonction <xref linkend="function.PDO-query" /> et que vous invoquez une erreur sur le gestionnaire de requête, <xref linkend="function.PDO-errorCode" /> ne retournera pas cette erreur. Vous devez appeler <xref linkend="function.PDOStatement-errorCode" /> pour retourner le code erreur pour une opération exécutée sur un gestionnaire de requête particulier. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Récupération d'un code SQLSTATE</title> <programlisting role="php"> <![CDATA[ <?php /* Provoque une erreur -- la table BONES n'existe pas */ $dbh->exec("INSERT INTO bones(skull) VALUES ('lucy')"); echo "\nPDO::errorCode(): "; print $dbh->errorCode(); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ PDO::errorCode(): 42S02 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-errorInfo" /></member> <member><xref linkend="function.PDOStatement-errorCode" /></member> <member><xref linkend="function.PDOStatement-errorInfo" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/errorinfo.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/errorinfo.xml +++ phpdoc-fr/reference/pdo/pdo/errorinfo.xml <?xml version='1.0' encoding='utf-8'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-errorInfo" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->errorInfo()</refname> <refpurpose> Retourne les informations associées à l'erreur lors de la dernière opération sur la base de données </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>array</type><methodname>errorInfo</methodname> <void/> </methodsynopsis> </classsynopsis> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDO-errorInfo" /> retourne un tableau contenant des informations sur l'erreur survenu lors de la dernière opération exécutée par ce gestionnaire de base de données. Le tableau contient les champs suivants : <informaltable> <tgroup cols='2'> <thead> <row> <entry>Ãlément</entry> <entry>Information</entry> </row> </thead> <tbody> <row> <entry>0</entry> <entry>code erreur SQLSTATE (un identifiant alphanumérique de cinq caractères défini dans le standard ANSI SQL).</entry> </row> <row> <entry>1</entry> <entry>Code erreur spécifique au driver.</entry> </row> <row> <entry>2</entry> <entry>Message d'erreur spécifique au driver.</entry> </row> </tbody> </tgroup> </informaltable> </para> <para> <xref linkend="function.PDO-errorInfo" /> retourne uniquement les informations des erreurs pour les opérations exécutées directement sur un gestionnaire de base de données. Si vous créez un objet PDOStatement avec la fonction <xref linkend="function.PDO-prepare" /> ou la fonction <xref linkend="function.PDO-query" /> et que vous invoquez une erreur sur le gestionnaire de requête, <xref linkend="function.PDO-errorInfo" /> ne retournera pas l'erreur depuis le gestionnaire de requête. Vous devez appeler la fonction <xref linkend="function.PDOStatement-errorInfo" /> pour retourner les informations sur l'erreur pour une opération exécutée sur un gestionnaire de requête particulier. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Affiche les champs de errorInfo() pour une connexion PDO_ODBC sur une base de donnés DB2</title> <programlisting role="php"> <![CDATA[ <?php /* Provoque une erreur -- mauvaise syntaxe SQL */ $stmt = $dbh->prepare('mauvaise syntaxe sql'); if (!$stmt) { echo "\nPDO::errorInfo():\n"; print_r($dbh->errorInfo()); } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ PDO::errorInfo(): Array ( [0] => 42S02 [1] => -204 [2] => [IBM][CLI Driver][DB2/LINUX] SQL0204N "DANIELS.BONES" is an undefined name. SQLSTATE=42704 ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-errorCode" /></member> <member><xref linkend="function.PDOStatement-errorCode" /></member> <member><xref linkend="function.PDOStatement-errorInfo" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/exec.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/exec.xml +++ phpdoc-fr/reference/pdo/pdo/exec.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-exec" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->exec()</refname> <refpurpose> Exécute une requête SQL et retourne le nombre de lignes affectées </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>int</type><methodname>exec</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <xref linkend="function.PDO-exec" /> exécute une requête SQL dans un appel d'une seule fonction, retourne le nombre de lignes affectées par la requête. </para> <para> <xref linkend="function.PDO-exec" /> ne retourne pas de résultat pour une requête SELECT. Pour une requête SELECT dont vous auriez besoin une seule fois dans le programme, utilisez plutôt la fonction <xref linkend="function.PDO-query" />. Pour une requête dont vous auriez besoin plusieurs fois, préparez un objet PDOStatement avec la fonction <xref linkend="function.PDO-prepare" /> et exécutez la requête avec la fonction <xref linkend="function.PDOStatement-execute" />. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>statement</parameter></term> <listitem> <para> La requête à préparer et à exécuter. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDO-exec" /> retourne le nombre de lignes qui ont été modifiées ou effacées pour la requête SQL qui vous exécutez. Si aucune ligne n'est affectée, la fonction <xref linkend="function.PDO-exec" /> retournera &zero;. </para> &return.falseproblem; <para> L'exemple suivant se fonde inexactement sur la valeur retournée par <xref linkend="function.PDO-exec" />, où une requête qui n'affecte aucune lignes revient à appeler <function>die</function> : <programlisting role="php"> <![CDATA[ <?php $db->exec() or die($db->errorInfo()); ?> ]]> </programlisting> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exécution d'une requête DELETE</title> <para> Compte le nombre de lignes effacées pour une requête DELETE avec aucune clause WHERE. </para> <programlisting role="php"> <![CDATA[ <?php $dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2'); /* Effacement de toutes les lignes de la table FRUIT */ $count = $dbh->exec("DELETE FROM fruit WHERE couleur = 'rouge'"); /* Retourne le nombre de lignes effacées */ print("Retourne le nombre de lignes effacées :\n"); print("Effacement de $count lignes.\n"); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Retourne le nombre de lignes effacées : Effacement de 2 lignes. ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDO-query" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/getattribute.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/getattribute.xml +++ phpdoc-fr/reference/pdo/pdo/getattribute.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-getAttribute" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->getAttribute()</refname> <refpurpose> Récupère un attribut d'une connexion à une base de données </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>mixed</type><methodname>getAttribute</methodname> <methodparam><type>int</type><parameter>attribute</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Cette fonction retourne la valeur d'un attribut d'une connexion à une base de données. Pour récupérer les attributs PDOStatement, référez-vous à la fonction <xref linkend="function.PDOStatement-getAttribute" />. </para> <para> Notez que quelques bases de données/drivers combinés ne supportent pas tous les attributs de connexion. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>attribute</parameter></term> <listitem> <para> Une des constantes <literal>PDO::ATTR_*</literal>. Les constantes qui sont appliquées aux connexions sont les suivantes : <simplelist> <member><literal>PDO::ATTR_AUTOCOMMIT</literal></member> <member><literal>PDO::ATTR_CASE</literal></member> <member><literal>PDO::ATTR_CLIENT_VERSION</literal></member> <member><literal>PDO::ATTR_CONNECTION_STATUS</literal></member> <member><literal>PDO::ATTR_DRIVER_NAME</literal></member> <member><literal>PDO::ATTR_ERRMODE</literal></member> <member><literal>PDO::ATTR_ORACLE_NULLS</literal></member> <member><literal>PDO::ATTR_PERSISTENT</literal></member> <member><literal>PDO::ATTR_PREFETCH</literal></member> <member><literal>PDO::ATTR_SERVER_INFO</literal></member> <member><literal>PDO::ATTR_SERVER_VERSION</literal></member> <member><literal>PDO::ATTR_TIMEOUT</literal></member> </simplelist> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Un appel réussi retourne la valeur de l'attribut PDO demandé. Un appel qui a échoué retourne la valeur <literal>null</literal>. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Récupération des attributs de connexion à une base de données</title> <programlisting role="php"> <![CDATA[ <?php $conn = new PDO('odbc:sample', 'db2inst1', 'ibmdb2'); $attributes = array( "AUTOCOMMIT", "ERRMODE", "CASE", "CLIENT_VERSION", "CONNECTION_STATUS", "ORACLE_NULLS", "PERSISTENT", "PREFETCH", "SERVER_INFO", "SERVER_VERSION", "TIMEOUT" ); foreach ($attributes as $val) { echo "PDO::ATTR_$val: "; echo $conn->getAttribute(constant("PDO::ATTR_$val")) . "\n"; } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-setAttribute" /></member> <member><xref linkend="function.PDOStatement-getAttribute" /></member> <member><xref linkend="function.PDOStatement-setAttribute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/lastinsertid.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/lastinsertid.xml +++ phpdoc-fr/reference/pdo/pdo/lastinsertid.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-lastInsertId" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->lastInsertId()</refname> <refpurpose> Retourne l'identifiant de la dernière ligne insérée ou la valeur d'une séquence </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>string</type><methodname>lastInsertId</methodname> <methodparam choice="opt"><type>string</type><parameter>name</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Retourne l'identifiant de la dernière ligne insérée, ou la dernière valeur d'une séquence d'objets, dépendamment du driver utilisé. Par exemple, <function>PDO_PGSQL</function> vous impose de spécifier le nom d'une séquence d'objet pour le paramètre <parameter>name</parameter>. </para> <note> <para> Cette méthode peut ne pas retourner un résultat significatif suivant les drivers PDO utilisés, car la base de données utilisée peut ne pas supporter la notion de champs auto-incrémenté ou de séquences. </para> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>name</parameter></term> <listitem> <para> Nom de la séquence d'objets depuis laquelle l'identifiant doit être retourné. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Si un nom de séquence n'est pas spécifié pour le paramètre <parameter>name</parameter>, <xref linkend="function.PDO-lastInsertId" /> retourne une chaîne représentant l'identifiant de la ligne de la dernière ligne insérée dans la base de données. </para> <para> Si un nom de séquence est spécifié pour le paramètre <parameter>name</parameter>, <xref linkend="function.PDO-lastInsertId" /> retourne une chaîne représentant la dernière valeur depuis la séquence d'objets spécifiée. </para> <para> Si le driver PDO ne supporte pas cette fonctionnalité, <xref linkend="function.PDO-lastInsertId" /> lancera un SQLSTATE <literal>IM001</literal>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/prepare.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/prepare.xml +++ phpdoc-fr/reference/pdo/pdo/prepare.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-prepare" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->prepare()</refname> <refpurpose> Prépare une requête à l'exécution et retourne un objet </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>PDOStatement</type><methodname>prepare</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>driver_options</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Prépare une requête SQL à être exécutée par la méthode <xref linkend="function.PDOStatement-execute" />. La requête SQL peut contenir zéro ou plusieurs noms (:name) ou marqueurs (?) pour lesquels les valeurs réelles seront substituées lorsque la requête sera exécutée. Vous ne pouvez pas utiliser les marqueurs nommés et les marqueurs interrogatifs dans une même requête SQL ; choisissez l'un ou l'autre. </para> <para> Vous devez inclure un marquer avec un nom unique pour chaque valeur que vous souhaitez passer dans la requête lorsque vous appelez <xref linkend="function.PDOStatement-execute" />. Vous ne pouvez pas utiliser un marqueur avec deux noms pareils dans une requête préparée. Vous ne pouvez associer plusieurs valeurs à un seul marqueur de nom entrant, par exemple, la clause IN() d'une requête SQL. </para> <para> Appeler <xref linkend="function.PDO-prepare" /> et <xref linkend="function.PDOStatement-execute" /> pour les requêtes qui doivent être exécutées plusieurs fois avec différentes valeurs de paramètres optimisent les performances de votre application en autorisant le driver à négocier coté client et/ou serveur avec le cache des requêtes et les métainformations, et aident à prévenir les attaques par injection SQL en éliminant le besoin de protéger les paramètres manuellement. </para> <para> PDO émulera les requêtes préparées / les paramètres liés pour les drivers qui ne le supportent pas nativement, et peut également réécrire les paramètres nommés ou les marqueurs en quelques choses de plus approprié, si le driver supporte un style mais pas l'autre. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>statement</parameter></term> <listitem> <para> Doit être une requête SQL valide pour le serveur de base de données cible. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>driver_options</parameter></term> <listitem> <para> Ce tableau contient une ou plusieurs paires clé=>valeur pour définir les valeurs des attributs pour l'objet PDOStatement que cette méthode retourne. Vous pouvez utiliser ceci pour définir la valeur <literal>PDO::ATTR_CURSOR</literal> à <literal>PDO::CURSOR_SCROLL</literal> pour demander un curseur scrollable. Quelques drivers ont des options spécifiques qui peuvent être définies au moment de la préparation. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Si le serveur de base de données prépare avec succès cette requête, <xref linkend="function.PDO-prepare" /> retourne un objet PDOStatement. Si le serveur de base de données ne réussit pas à préparer la requête, <xref linkend="function.PDO-prepare" /> retourne &false;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Prépare une requête SQL avec des paramètres nommés</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en passant un tableau de valeurs */ $sql = 'SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'; $sth = $dbh->prepare($sql, array(PDO::ATTR_CURSOR => PDO::CURSOR_FWDONLY)); $sth->execute(array(':calories' => 150, ':couleur' => 'red')); $red = $sth->fetchAll(); $sth->execute(array('calories' => 175, 'couleur' => 'yellow')); $yellow = $sth->fetchAll(); ?> ]]> </programlisting> </example> <example> <title>Prépare une requête SQL avec des marqueurs</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en passant un tableau de valeurs */ $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); $sth->execute(array(150, 'rouge')); $red = $sth->fetchAll(); $sth->execute(array(175, 'jaune')); $yellow = $sth->fetchAll(); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-exec" /></member> <member><xref linkend="function.PDO-query" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/query.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/query.xml +++ phpdoc-fr/reference/pdo/pdo/query.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-query" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->query()</refname> <refpurpose> Exécute une requête SQL, retourne un jeu de résultats en tant qu'objet PDOStatement </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>PDOStatement</type><methodname>query</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> </methodsynopsis> </classsynopsis> <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>query</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> <methodparam><type>int</type><parameter>PDO::FETCH_COLUMN</parameter></methodparam> <methodparam><type>int</type><parameter>colno</parameter></methodparam> </methodsynopsis> </classsynopsis> <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>query</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> <methodparam><type>int</type><parameter>PDO::FETCH_CLASS</parameter></methodparam> <methodparam><type>string</type><parameter>classname</parameter></methodparam> <methodparam><type>array</type><parameter>ctorargs</parameter></methodparam> </methodsynopsis> </classsynopsis> <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>query</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> <methodparam><type>int</type><parameter>PDO::FETCH_INTO</parameter></methodparam> <methodparam><type>object</type><parameter>object</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <xref linkend="function.PDO-query" /> exécute une requête SQL en appelant une seule fonction, retourne le jeu de résultats (s'il y en a) retourné par la requête en tant qu'objet PDOStatement. </para> <para> Pour une requête que vous devez exécuter plusieurs fois, vous réaliserez de meilleurs performances si vous préparez l'objet PDOStatement en utilisant la fonction <xref linkend="function.PDO-prepare" /> et exécutez la requête via plusieurs appels à la fonction <xref linkend="function.PDOStatement-execute" />. </para> <para> Si vous ne récupérez pas toutes les données du jeux de résultats avant d'exécuter le prochain appel à <xref linkend="function.PDO-query" />, votre appel peut échouer. Appeler <xref linkend="function.PDOStatement-closeCursor" /> pour libérer les ressources de la base de données associées à l'objet PDOStatement avant d'exécuter votre prochain appel à la fonction <xref linkend="function.PDO-query" />. </para> <note> <para> Bien que la documentation de cette fonction autorise de passer un seul paramètre, vous pouvez y passer d'autres paramètres. Ils seront traités via l'appel à <xref linkend="function.PDOStatement-setFetchMode" /> sur le résultat du traitement de l'objet. </para> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>statement</parameter></term> <listitem> <para> La requête SQL à préparer et à exécuter. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDO-query" /> retourne un objet PDOStatement. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec PDO::query</title> <para> Une fonctionnalité intéressante de <xref linkend="function.PDO-query" /> est qu'il vous permet d'itérer à travers un jeu de résultats retourné par une requête SELECT exécutée avec succès. </para> <programlisting role="php"> <![CDATA[ <?php function getFruit($conn) { $sql = 'SELECT name, colour, calories FROM fruit ORDER BY name'; foreach ($conn->query($sql) as $row) { print $row['NAME'] . "\t"; print $row['COLOUR'] . "\t"; print $row['CALORIES'] . "\n"; } } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ apple red 150 banana yellow 250 kiwi brown 75 lemon yellow 25 orange orange 300 pear green 150 watermelon pink 90 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-exec" /></member> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/quote.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/quote.xml +++ phpdoc-fr/reference/pdo/pdo/quote.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-quote" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->quote()</refname> <refpurpose> Protège une chaîne pour l'utiliser dans une requête SQL PDO </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>string</type><methodname>quote</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>parameter_type</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <xref linkend="function.PDO-quote" /> place des guillemets simples autour d'une chaîne d'entrées (si nécessaire) et échappe les caractères spéciaux présents dans la chaîne d'entrées, en utilisant le style de protection approprié au driver courant. </para> <para> Si vous utilisez cette fonction pour construire des requêtes SQL, vous êtes <emphasis>vivement</emphasis> invité à utiliser <xref linkend="function.PDO-prepare" /> pour préparer les requêtes SQL avec des paramètres liées au lieu d'utiliser <xref linkend="function.PDO-quote" /> pour interpréter les entrées utilisateurs dans la requête SQL. Les requêtes préparées avec des paramètres liées ne sont pas seulement plus portables, plus malléables et plus sécurisées mais bien plus rapides à exécuter que d'interpréter les requêtes, étant donné que les côtés client et serveur peuvent mettre en cache une version compilée de la requête. </para> <para> Tous les drivers PDO n'implémentent pas cette méthode (comme PDO_ODBC). Utilisez les requêtes préparées à la place. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>string</parameter></term> <listitem> <para> La chaîne à échapper. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>parameter_type</parameter></term> <listitem> <para> Fournit un type de données pour les drivers qui ont des styles alternatifs d'échappement. La valeur par défaut est PDO::PARAM_STR. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne une chaîne échappée qui est théoriquement sûr à passer dans une requête SQL. Retourne &false; si le driver ne supporte pas la protection en ce sens. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Protection d'une chaîne normale</title> <programlisting role="php"> <![CDATA[ <?php $conn = new PDO('sqlite:/home/lynn/music.sql3'); /* Chaîne simple */ $string = 'Nice'; print "Chaîne non échappée : $string\n"; print "Chaîne échappée : " . $conn->quote($string) . "\n"; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Chaîne non échappée : Nice Chaîne échappée: 'Nice' ]]> </screen> </example> <example> <title>Echappement d'une chaîne dangereuse</title> <programlisting role="php"> <![CDATA[ <?php $conn = new PDO('sqlite:/home/lynn/music.sql3'); /* Chaîne dangereuse */ $string = 'Chaîne \' particulière'; print "Chaîne non échappée : $string\n"; print "Chaîne échappée :" . $conn->quote($string) . "\n"; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Chaîne non échappée : Chaîne ' particulière Chaîne échappée : 'Chaîne '' particulière' ]]> </screen> </example> <example> <title>Echappement d'une chaîne complexe</title> <programlisting role="php"> <![CDATA[ <?php $conn = new PDO('sqlite:/home/lynn/music.sql3'); /* Chaîne complexe */ $string = "Co'mpl''exe \"ch'\"aîne"; print "Chaîne non échappée: $string\n"; print "Chaîne échappée : " . $conn->quote($string) . "\n"; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Chaîne non échappée: Co'mpl''exe "ch'"aîne Chaîne échappée: 'Co''mpl''''exe "ch''"aîne' ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/rollback.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/rollback.xml +++ phpdoc-fr/reference/pdo/pdo/rollback.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-rollBack" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->rollBack()</refname> <refpurpose> Annule une transaction </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>rollBack</methodname> <void/> </methodsynopsis> </classsynopsis> <para> Annule la transaction courante, initié par la fonction <xref linkend="function.PDO-beginTransaction" />. C'est une erreur que d'appeler cette méthode s'il n'y a aucune transaction active. </para> <para> Si la base de données est en mode autocommit, cette fonction restaurera le mode autocommit après l'annulation de la transaction. </para> <para> Quelques bases de données, dont MySQL, exécuteront automatiquement un COMMIT lorsqu'une requête de définition de langage de base de données (DDL) comme DROP TABLE ou CREATE TABLE est exécutée dans une transaction. Ce COMMIT implicite vous empêchera d'annuler toutes autres modifications faites dans cette transaction. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Annulation d'une transaction</title> <para> L'exemple suivant commence une transaction et exécute deux requêtes qui modifient la base de données avant d'annuler les modifications. Sur MySQL, cependant, la requête DROP TABLE validera automatiquement la transaction, donc, aucune des modifications de la transaction ne sera annulée. </para> <programlisting role='php'> <![CDATA[ <?php /* Début d'une transaction, désactivation du mode autocommit */ $dbh->beginTransaction(); /* Modifie le schéma de la base de données ainsi que des données */ $sth = $dbh->exec("DROP TABLE fruit"); $sth = $dbh->exec("UPDATE dessert SET name = 'hamburger'"); /* On s'aperçoit d'une erreur et on annule les modifications */ $dbh->rollBack(); /* La connexion à la base de donnés revient en mode autocommit */ ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-beginTransaction" /></member> <member><xref linkend="function.PDO-commit" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/bindcolumn.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/bindcolumn.xml +++ phpdoc-fr/reference/pdo/pdostatement/bindcolumn.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-bindColumn" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->bindColumn()</refname> <refpurpose> Lie une colonne à une variable PHP </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>bindColumn</methodname> <methodparam><type>mixed</type><parameter>column</parameter></methodparam> <methodparam><type>mixed</type><parameter role="reference">param</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <xref linkend="function.PDOStatement-bindColumn" /> fait en sorte qu'une variable particulière soit liée à une colonne données dans le jeu de résultats depuis une requête. Chaque appel à la fonction <xref linkend="function.PDOStatement-fetch" /> ou <xref linkend="function.PDOStatement-fetchAll" /> mettra à jour toutes les variables qui sont liées aux colonnes. </para> <note> <para> Étant donné que les informations sur les colonnes ne sont pas toujours disponibles à PDO tant que la requête n'est pas exécutée, les applications portables doivent appeler cette fonction <emphasis>après</emphasis> la fonction <xref linkend="function.PDOStatement-execute" />. </para> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>column</parameter></term> <listitem> <para> Numéro de la colonne (en commençant à 1) ou nom de la colonne dans le jeu de résultats. Si vous utilisez les noms de colonnes, assurez-vous que le nom corresponde à la casse de la colonne, comme retourné par le driver. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>param</parameter></term> <listitem> <para> Nom de la variable PHP à laquelle la colonne doit être liée. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>type</parameter></term> <listitem> <para> Type du paramètre, spécifié par les constantes PDO::PARAM_*. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Lie l'affichage du jeu de résultats à des variables PHP</title> <para> Lie les colonnes du jeu de résultats aux variables PHP est une façon agréable de rendre les données contenues dans chaque ligne immédiatement disponible à votre application. L'exemple suivant montre comment PDO vous autorise à lier et récupérer les colonnes avec une variété d'options. </para> <programlisting role="php"> <![CDATA[ <?php function readData($dbh) { $sql = 'SELECT nom, couleur, calories FROM fruit'; try { $stmt = $dbh->prepare($sql); $stmt->execute(); /* Lie par les numéros de colonnes */ $stmt->bindColumn(1, $nom); $stmt->bindColumn(2, $couleur); /* Lie par les noms de colonnes */ $stmt->bindColumn('calories', $cals); while ($row = $stmt->fetch(PDO::FETCH_BOUND)) { $data = $nom . "\t" . $couleur . "\t" . $cals . "\n"; print $data; } } catch (PDOException $e) { print $e->getMessage(); } } readData($dbh); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ pomme rouge 150 banane jaune 175 kiwi vert 75 orange orange 150 mangue rouge 200 fraise rouge 25 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDOStatement-execute" /></member> <member><xref linkend="function.PDOStatement-fetch" /></member> <member><xref linkend="function.PDOStatement-fetchAll" /></member> <member><xref linkend="function.PDOStatement-fetchColumn" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/bindparam.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/bindparam.xml +++ phpdoc-fr/reference/pdo/pdostatement/bindparam.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-bindParam" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->bindParam()</refname> <refpurpose> Lie un paramètre à un nom de variable spécifique </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>bindParam</methodname> <methodparam><type>mixed</type><parameter>parameter</parameter></methodparam> <methodparam><type>mixed</type><parameter role="reference">variable</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>data_type</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>driver_options</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Lie une variable PHP à un marquer nommé ou interrogatif correspondant dans une requête SQL utilisée pour préparer la requête. Contrairement à <xref linkend="function.PDOStatement-bindValue" />, la variable est liée en tant que référence et ne sera évaluée qu'au moment de l'appel à la fonction <xref linkend="function.PDOStatement-execute" />. </para> <para> La plupart des paramètres sont des paramètres d'entrées, et sont utilisés en lecture seule pour construire la requête. Quelques drivers supportent l'invocation de procédures stockées qui retournent des données en tant que paramètres de sortie, et quelques autres en tant que paramètres entrées / sorties qui sont envoyés ensemble et sont mis à jour pour les recevoir. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>parameter</parameter></term> <listitem> <para> Identifiant. Pour une requête préparée utilisant des marqueurs nommés, ce sera le nom du paramètre sous la forme <varname>:name</varname>. Pour une requête préparée utilisant les marqueurs interrogatifs, ce sera la position indexé -1 du paramètre. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>variable</parameter></term> <listitem> <para> Nom de la variable PHP à lier au paramètre de la requête SQL. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>data_type</parameter></term> <listitem> <para> Type explicite de données pour le paramètre utilisant la constante PDO::PARAM_*. Pour retourner un paramètre INOUT depuis une procédure stockée, utilisez l'opérateur OR pour définir l'octet PDO::PARAM_INPUT_OUTPUT pour le paramètre <parameter>data_type</parameter>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>length</parameter></term> <listitem> <para> Longueur du type de données. Pour indiquer qu'un paramètre est un paramètre OUT depuis une procédure stockée, vous devez explicitement définir la longueur. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>driver_options</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title> Exécution d'une requête préparée avec des emplacements nommés </title> <programlisting role='php'> <![CDATA[ <?php /* Exécution d'une requête préparée en liant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); $sth->bindParam(':calories', $calories, PDO::PARAM_INT); $sth->bindParam(':couleur', $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> </programlisting> </example> <example> <title> Exécution d'une requête préparée avec des marques de positionnement </title> <programlisting role='php'> <![CDATA[ <?php /* Exécution d'une requête préparée en liant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); $sth->bindParam(1, $calories, PDO::PARAM_INT); $sth->bindParam(2, $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> </programlisting> </example> <example> <title>Appel une procédure stockée avec un paramètre INOUT</title> <programlisting role='php'> <![CDATA[ <?php /* Appel une procédure stockée avec un paramètre INOUT */ $couleur = 'rouge'; $sth = $dbh->prepare('CALL puree_fruit(?)'); $sth->bindParam(1, $couleur, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 12); $sth->execute(); print("Après avoir pressé le fruit, la couleur est : $couleur"); ?> ]]> </programlisting> </example> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> <member><xref linkend="function.PDOStatement-bindValue" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/bindvalue.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/bindvalue.xml +++ phpdoc-fr/reference/pdo/pdostatement/bindvalue.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-bindValue" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->bindValue()</refname> <refpurpose> Associe une valeur à un paramètre </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>bindValue</methodname> <methodparam><type>mixed</type><parameter>parameter</parameter></methodparam> <methodparam><type>mixed</type><parameter>value</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>data_type</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Associe une valeur à un nom correspondant ou à un point d'interrogation (comme paramètre fictif) dans la requête SQL qui fut utilisée pour préparer la requête. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>parameter</parameter></term> <listitem> <para> Identifiant du paramètre. Pour une requête préparée utilisant les marqueurs, cela sera un nom de paramètre de la forme <varname>:nom</varname>. Pour une requête préparée utilisant les points d'interrogation (comme paramètre fictif), cela sera un tableau indexé numériquement qui commence à la position 1 du paramètre. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>value</parameter></term> <listitem> <para> La valeur à associer au paramètre. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>data_type</parameter></term> <listitem> <para> Type de données explicite pour le paramètre utilisant les constantes PDO::PARAM_*. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exécute une requête préparée avec des marqueurs nommés</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en associant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); $sth->bindValue(':calories', $calories, PDO::PARAM_INT); $sth->bindValue(':couleur', $couleur, PDO::PARAM_STR); $sth->execute(); ?> ]]> </programlisting> </example> <example> <title>Exécute une requête préparée avec des points d'interrogation comme paramètre fictif</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en associant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); $sth->bindValue(1, $calories, PDO::PARAM_INT); $sth->bindValue(2, $couleur, PDO::PARAM_STR); $sth->execute(); ?> ]]> </programlisting> </example> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> <member><xref linkend="function.PDOStatement-bindParam" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/closecursor.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/closecursor.xml +++ phpdoc-fr/reference/pdo/pdostatement/closecursor.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-closeCursor" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->closeCursor()</refname> <refpurpose> Ferme le curseur, permettant à la requête d'être de nouveau exécutée </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>closeCursor</methodname> <void/> </methodsynopsis> </classsynopsis> <para> <xref linkend="function.PDOStatement-closeCursor" /> libère la connexion du serveur, permettant ainsi à d'autres requêtes SQL d'être exécutées, mais quitte la requête, permettant ainsi qu'elle soit de nouveau exécutée. </para> <para> Cette méthode est utile pour les drivers de base de données qui ne supportent pas l'exécution d'objet PDOStatement lorsqu'un objet PDOStatement exécuté précédemment a encore des lignes non récupérées. Si votre driver de base de données souffre de cette limitation, le problème se manifestera de lui-même dans une erreur en dehors de la séquence. </para> <para> <xref linkend="function.PDOStatement-closeCursor" /> est implémenté soit en tant que méthode optionnelle spécifique au driver (autorisant un maximum d'efficacité), ou en tant que fallback PDO générique si aucune fonction spécifique au driver n'est installée. Le fallback générique PDO est sémantiquement la même chose que d'écrire le code suivant dans votre script PHP : <programlisting role="php"> <![CDATA[ <?php do { while ($stmt->fetch()) ; if (!$stmt->nextRowset()) break; } while (true); ?> ]]> </programlisting> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <xref linkend="function.PDOStatement-closeCursor" /></title> <para> Dans l'exemple suivant, l'objet PDOStatement <varname>$stmt</varname> retourne de multiples lignes mais l'application récupère uniquement la première ligne, laissant l'objet PDOStatement dans l'état où il lui reste des lignes non récupérées. Pour vous assurez que l'application fonctionnera avec tous les drivers de base de données, l'auteur insère un appel à la fonction <xref linkend="function.PDOStatement-closeCursor" /> sur <varname>$stmt</varname> avant l'exécution d'objet PDOStatement <varname>$otherStmt</varname>. </para> <programlisting role="php"> <![CDATA[ <?php /* Création d'un objet PDOStatement */ $stmt = $dbh->prepare('SELECT foo FROM bar'); /* Création d'un second objet PDOStatement */ $otherStmt = $dbh->prepare('SELECT foobaz FROM foobar'); /* Exécute la première requête */ $stmt->execute(); /* Récupération de la première ligne uniquement depuis le résultat */ $stmt->fetch(); /* L'appel suivant à closeCursor() peut être requis par quelques drivers */ $stmt->closeCursor(); /* Maintenant, nous pouvons exécuter la deuxième requête */ $otherStmt->execute(); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDOStatement-execute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/columncount.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/columncount.xml +++ phpdoc-fr/reference/pdo/pdostatement/columncount.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-columnCount" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->columnCount()</refname> <refpurpose> Retourne le nombre de colonnes dans le jeu de résultats </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>int</type><methodname>columnCount</methodname> <void/> </methodsynopsis> </classsynopsis> <para> Utilisez la fonction <xref linkend="function.PDOStatement-columnCount" /> pour retourner le nombre de colonnes dans le jeu de résultats représenté par l'objet PDOStatement. </para> <para> Si l'objet PDOStatement a été retourné par la fonction <xref linkend="function.PDO-query" />, le nombre de colonnes est immédiatement disponible. </para> <para> Si l'objet PDOStatement a été retourné par la fonction <xref linkend="function.PDO-prepare" />, un compte précis des colonnes ne sera pas disponible tant que vous n'invoquerez pas la fonction <xref linkend="function.PDOStatement-execute" />. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne le nombre de colonnes dans le jeu de résultats représenté par l'objet PDOStatement. S'il n'y a pas de jeu de résultats, <xref linkend="function.PDOStatement-columnCount" /> retournera &zero;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Comptage des colonnes</title> <para> Cet exemple démontre comment <xref linkend="function.PDOStatement-columnCount" /> fonctionne avec ou sans jeu de résultats. </para> <programlisting role="php"> <![CDATA[ <?php $dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2'); $sth = $dbh->prepare("SELECT nom, couleur FROM fruit"); /* Compte le nombre de colonnes dans le jeu de résultat (non-existant) */ $colcount = $sth->columnCount(); print("Avant execute(), le jeu de résultats avait $colcount colonnes (devrait être 0)\n"); $sth->execute(); /* Compte le nombre de colonnes dans le jeu de résultats */ $colcount = $sth->columnCount(); print("Après execute(), le jeu de résultats a $colcount colonnes (devrait être 2)\n"); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Avant execute(), le jeu de résultats avait 0 colonnes (devrait être 0) Après execute(), le jeu de résultat a 2 colonnes (devrait être 2) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> <member><xref linkend="function.PDOStatement-rowCount" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/errorcode.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/errorcode.xml +++ phpdoc-fr/reference/pdo/pdostatement/errorcode.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-errorCode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->errorCode()</refname> <refpurpose> Récupère le SQLSTATE associé lors de la dernière opération sur la requête </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>string</type><methodname>errorCode</methodname> <void/> </methodsynopsis> </classsynopsis> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Identique à <xref linkend="function.PDO-errorCode" />, excepté que <xref linkend="function.PDOStatement-errorCode" /> récupère uniquement les codes erreurs pour les opérations sur les objets PDOStatement. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Détermine la catégorie de l'erreur qui survient</title> <programlisting role="php"> <![CDATA[ <?php /* Provoque une erreur -- la table BONES n'existe pas */ $err = $dbh->prepare('SELECT skull FROM bones'); $err->execute(); echo "\nPDOStatement::errorCode(): "; print $err->errorCode(); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ PDOStatement::errorCode(): 42S02 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-errorCode" /></member> <member><xref linkend="function.PDO-errorInfo" /></member> <member><xref linkend="function.PDOStatement-errorInfo" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/errorinfo.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/errorinfo.xml +++ phpdoc-fr/reference/pdo/pdostatement/errorinfo.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-errorInfo" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->errorInfo()</refname> <refpurpose> Récupère les informations sur l'erreur associée lors dernière opération sur la requête </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>array</type><methodname>errorInfo</methodname> <void/> </methodsynopsis> </classsynopsis> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDOStatement-errorInfo" /> retourne un tableau contenant des informations sur l'erreur survenu lors de la dernière opération exécutée par ce gestionnaire de requêtes. Le tableau contient les champs suivants : <informaltable> <tgroup cols='2'> <thead> <row> <entry>Élément</entry> <entry>Information</entry> </row> </thead> <tbody> <row> <entry>0</entry> <entry>Code erreur SQLSTATE (un identifiant de cinq caractères alphanumériques défini dans le standard ANSI SQL)</entry> </row> <row> <entry>1</entry> <entry>Code erreur spécifique au driver.</entry> </row> <row> <entry>2</entry> <entry>Message d'erreur spécifique au driver.</entry> </row> </tbody> </tgroup> </informaltable> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Affiche les champs de errorInfo() pour une connexion PDO_ODBC sur une base de donnés DB2</title> <programlisting role="php"> <![CDATA[ <?php /* Provoque une erreur -- la table BONES n'existe pas */ $sth = $dbh->prepare('SELECT skull FROM bones'); $sth->execute(); echo "\nPDOStatement::errorInfo():\n"; $arr = $sth->errorInfo(); print_r($arr); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ PDOStatement::errorInfo(): Array ( [0] => 42S02 [1] => -204 [2] => [IBM][CLI Driver][DB2/LINUX] SQL0204N "DANIELS.BONES" is an undefined name. SQLSTATE=42704 ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-errorCode" /></member> <member><xref linkend="function.PDO-errorInfo" /></member> <member><xref linkend="function.PDOStatement-errorCode" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/execute.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/execute.xml +++ phpdoc-fr/reference/pdo/pdostatement/execute.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-execute" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->execute()</refname> <refpurpose> Exécute une requête préparée </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>execute</methodname> <methodparam choice="opt"><type>array</type><parameter>input_parameters</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Exécute une requête préparée. Si la requête préparée inclut des marqueurs de positionnement, vous pouvez : <itemizedlist> <listitem><para>appeler la fonction <xref linkend="function.PDOStatement-bindParam" /> pour lier les variables PHP aux marqueurs de positionnement : les variables liées passent leurs valeurs en entrée et reçoivent les valeurs de sortie, s'il y en a, de leurs marqueurs de positionnement respectifs</para></listitem> <listitem><para>ou passer un tableau de valeurs de paramètres, uniquement en entrée</para></listitem> </itemizedlist> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>input_parameters</parameter></term> <listitem> <para> Un tableau de valeurs avec autant d'éléments qu'il y a de paramètres à associer dans la requête SQL qui sera exécutées. </para> <para> Vous ne pouvez associer plusieurs valeurs à un seul paramètre; par exemple, vous ne pouvez associer deux valeurs à un paramètre de nom dans une clause IN(). </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exécute une requête préparée avec des variables liées</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en liant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); $sth->bindParam(':calories', $calories, PDO::PARAM_INT); $sth->bindParam(':couleur', $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> </programlisting> </example> <example> <title>Exécute une requête préparée avec un tableau de valeurs (paramètres de nom)</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en passant un tableau de valeurs */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); $sth->execute(array(':calories' => $calories, ':couleur' => $couleur)); ?> ]]> </programlisting> </example> <example> <title>Exécute une requête préparée avec un tableau de valeurs (marqueurs)</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en passant un tableau de valeurs */ $calories = 150; $colour = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); $sth->execute(array($calories, $couleur)); ?> ]]> </programlisting> </example> <example> <title>Exécute une requête préparée avec un marqueur de positionnement</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en liant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); $sth->bindParam(1, $calories, PDO::PARAM_INT); $sth->bindParam(2, $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> </programlisting> </example> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-bindParam" /></member> <member><xref linkend="function.PDOStatement-fetch" /></member> <member><xref linkend="function.PDOStatement-fetchAll" /></member> <member><xref linkend="function.PDOStatement-fetchColumn" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/fetch.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/fetch.xml +++ phpdoc-fr/reference/pdo/pdostatement/fetch.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-fetch" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->fetch()</refname> <refpurpose> Récupère la ligne suivante d'un jeu de résultat PDO </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>mixed</type><methodname>fetch</methodname> <methodparam choice="opt"><type>int</type><parameter>fetch_style</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>cursor_orientation</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>cursor_offset</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Récupère une ligne depuis un jeu de résultats associé à l'objet <literal>PDOStatement</literal>. Le paramètre <parameter>fetch_style</parameter> détermine la façon dont PDO retourne la ligne. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>fetch_style</parameter></term> <listitem> <para> Contrôle comment la prochaine ligne sera retournée à l'appelant. Cette valeur doit être une des constantes <literal>PDO::FETCH_*</literal>, et par défaut, vaut <literal>PDO::FETCH_BOTH</literal>. <itemizedlist> <listitem><para> <literal>PDO::FETCH_ASSOC</literal>: retourne un tableau indexé par le nom de la colonne comme retourné dans le jeu de résultats </para></listitem> <listitem><para> <literal>PDO_FETCH_BOTH</literal> (défaut): retourne un tableau indexé par les noms de colonnes mais aussi par les numéros de colonnes (commençant à l'indice 0), comme retournés dans le jeu de résultats </para></listitem> <listitem><para> <literal>PDO::FETCH_BOUND</literal>: retourne &true; et assigne les valeurs des colonnes de votre jeu de résultats dans les variables PHP à laquelle elles sont liées avec la méthode <xref linkend="function.PDOStatement-bindParam" /> </para></listitem> <listitem><para> <literal>PDO::FETCH_CLASS</literal>: retourne une nouvelle instance de la classe demandée, liant les colonnes du jeu de résultats aux noms des propriétés de la classe. Si <parameter>fetch_style</parameter> inclut PDO::FETCH_CLASS (c'est-à-dire <literal>PDO::FETCH_CLASS | PDO::FETCH_CLASSTYPE</literal>), alors le nom de la classe est déterminé à partir d'une valeur de la première colonne. </para></listitem> <listitem><para> <literal>PDO::FETCH_INTO</literal>: met à jour une instance existante de la classe demandée, liant les colonnes du jeu de résultats aux noms des propriétés de la classe </para></listitem> <listitem><para> <literal>PDO::FETCH_LAZY</literal>: combine <literal>PDO::FETCH_BOTH</literal> et <literal>PDO::FETCH_OBJ</literal>, créant ainsi les noms des variables de l'objet, comme elles sont accédées </para></listitem> <listitem><para> <literal>PDO::FETCH_NUM</literal>: retourne un tableau indexé par le numéro de la colonne comme elle est retourné dans votre jeu de résultat, commençant à 0 </para></listitem> <listitem><para> <literal>PDO_FETCH_OBJ</literal>: retourne un objet anonyme avec les noms de propriétés qui correspondent aux noms des colonnes retournés dans le jeu de résultats </para></listitem> </itemizedlist> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>cursor_orientation</parameter></term> <listitem> <para> Pour un objet PDOStatement représentant un curseur scrollable, cette valeur détermine quelle ligne sera retournée à l'appelant. Cette valeur doit être une des constantes <literal>PDO::FETCH_ORI_*</literal>, et par défaut, vaut <literal>PDO::FETCH_ORI_NEXT</literal>. Pour demander un curseur scrollable pour votre objet PDOStatement, vous devez définir l'attribut <literal>PDO::ATTR_CURSOR</literal> à <literal>PDO::CURSOR_SCROLL</literal> lorsque vous préparez la requête SQL avec la fonction <xref linkend="function.PDO-prepare" />. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Pour un objet PDOStatement représentant un curseur scrollable pour lequel le paramètre <literal>cursor_orientation</literal> est défini à <literal>PDO::FETCH_ORI_ABS</literal>, cette valeur spécifie le numéro absolu de la ligne dans le jeu de résultats qui doit être récupérée. </para> <para> Pour un objet PDOStatement représentant un curseur scrollable pour lequel le paramètre <literal>cursor_orientation</literal> est défini à <literal>PDO::FETCH_ORI_REL</literal>, cette valeur spécifie la ligne à récupérer relativement à la position du curseur avant l'appel à la fonction <xref linkend="function.PDOStatement-fetch" />. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Récupération de lignes en utilisant différentes méthodes</title> <programlisting role="php"> <![CDATA[ <?php $sth = $dbh->prepare("SELECT nom, couleur FROM fruit"); $sth->execute(); /* styles PDOStatement::fetch */ print("PDO::FETCH_ASSOC: "); print("Retourne la ligne suivante en tant qu'un tableau indexé par le nom des colonnes\n"); $result = $sth->fetch(PDO::FETCH_ASSOC); print_r($result); print("\n"); print("PDO::FETCH_BOTH: "); print("Retourne la ligne suivante en tant qu'un tableau indexé par le nom et le numéro de la colonne\n"); $result = $sth->fetch(PDO::FETCH_BOTH); print_r($result); print("\n"); print("PDO::FETCH_LAZY: "); print("Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés\n"); $result = $sth->fetch(PDO::FETCH_LAZY); print_r($result); print("\n"); print("PDO::FETCH_OBJ: "); print("Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés\n"); $result = $sth->fetch(PDO::FETCH_OBJ); print $result->NAME; print("\n"); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ PDO::FETCH_ASSOC: Retourne la ligne suivante en tant qu'un tableau indexé par le nom des colonnes Array ( [NOM] => apple [COULEUR] => red ) PDO::FETCH_BOTH: Retourne la ligne suivante en tant qu'un tableau indexé par le nom et le numéro de la colonne Array ( [NOM] => banana [0] => banana [COULEUR] => yellow [1] => yellow ) PDO::FETCH_LAZY: Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés PDORow Object ( [NOM] => orange [COULEUR] => orange ) PDO::FETCH_OBJ: Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés kiwi ]]> </screen> </example> <example> <title>Récupération des lignes avec un curseur scrollable</title> <programlisting role="php"> <![CDATA[ <?php function readDataForwards($dbh) { $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY BET'; try { $stmt = $dbh->prepare($sql, array(PDO::ATTR_CURSOR, PDO::CURSOR_SCROLL)); $stmt->execute(); while ($row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_NEXT)) { $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n"; print $data; } $stmt = null; } catch (PDOException $e) { print $e->getMessage(); } } function readDataBackwards($dbh) { $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY bet'; try { $stmt = $dbh->prepare($sql, array(PDO::ATTR_CURSOR, PDO::CURSOR_SCROLL)); $stmt->execute(); $row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_LAST); do { $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n"; print $data; } while ($row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_PRIOR)); $stmt = null; } catch (PDOException $e) { print $e->getMessage(); } } print "Lecture en avant :\n"; readDataForwards($conn); print "Lecture en arrière :\n"; readDataBackwards($conn); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Lecture en avant : 21 10 5 16 0 5 19 20 10 Lecture en arrière : 19 20 10 16 0 5 21 10 5 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-query" /></member> <member><xref linkend="function.PDOStatement-fetchAll" /></member> <member><xref linkend="function.PDOStatement-fetchColumn" /></member> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-setFetchMode" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/fetchall.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/fetchall.xml +++ phpdoc-fr/reference/pdo/pdostatement/fetchall.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-fetchAll" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->fetchAll()</refname> <refpurpose> Retourne un tableau contenant toutes les lignes du jeu d'enregistrements </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>array</type><methodname>fetchAll</methodname> <methodparam choice="opt"><type>int</type><parameter>fetch_style</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>column_index</parameter></methodparam> </methodsynopsis> </classsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>fetch_style</parameter></term> <listitem> <para> Contrôle le contenu du tableau retourné comme documenté dans la fonction <xref linkend="function.PDOStatement-fetch" />. Vaut par défaut <literal>PDO::FETCH_BOTH</literal>. </para> <para> Pour retourner un tableau contenant toutes les valeurs d'une seule colonne depuis le jeu de résultats, spécifiez <literal>PDO::FETCH_COLUMN</literal>. Vous pouvez spécifier quelle colonne vous voulez avec le paramètre <parameter>column-index</parameter>. </para> <para> Pour récupérer uniquement les valeurs uniques d'une seule colonne depuis le jeu de résultats, utilisez <literal>PDO::FETCH_COLUMN</literal> avec <literal>PDO::FETCH_UNIQUE</literal>. </para> <para> Pour retourner un tableau associatif groupé par les valeurs d'une colonne spécifique, utilisez <literal>PDO::FETCH_COLUMN</literal> avec <literal>PDO::FETCH_GROUP</literal>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>column_index</parameter></term> <listitem> <para> Retourne la colonne indiquée où la valeur de <parameter>fetch_style</parameter> est <literal>PDO::FETCH_COLUMN</literal>. Vaut par défaut &zero;. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDOStatement-fetchAll" /> retourne un tableau contenant toutes les lignes du jeu d'enregistrements. Le tableau représente chaque ligne comme soit un tableau de valeurs des colonnes, soit un objet avec des propriétés correspondant à chaque nom de colonne. </para> <para> L'utilisation de cette méthode pour récupérer de gros jeux de résultats peut augmenter les ressources du systèmes mais également ces ressources. Plutôt que de récupérer toutes les données et de les manipuler avec PHP, utilisez le serveur de base de données pour manipuler les jeux de résultats. Par exemple, utilisez les clauses <literal>WHERE</literal> et <literal>ORDER BY</literal> dans vos requêtes SQL pour restreindre les résultats avant de le récupérer et de les traiter avec PHP. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Récupération de toutes les lignes d'un jeu de résultats</title> <programlisting role="php"> <![CDATA[ <?php $sth = $dbh->prepare("SELECT nom, couleur FROM fruit"); $sth->execute(); /* Récupération de toutes les lignes d'un jeu de résultats */ print("Récupération de toutes les lignes d'un jeu de résultats :\n"); $result = $sth->fetchAll(); print_r($result); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Récupération de toutes les lignes d'un jeu de résultats : Array ( [0] => Array ( [NOM] => pear [0] => pear [COULEUR] => green [1] => green ) [1] => Array ( [NOM] => watermelon [0] => watermelon [COULEUR] => pink [1] => pink ) ) ]]> </screen> </example> <example> <title>Récupération de toutes les valeurs d'une seule colonne depuis un jeu de résultats</title> <para> L'exemple suivant montre comment retourner toutes les valeurs d'une seule colonne depuis un jeu de résultats, même si la requête SQL retourne plusieurs colonnes par lignes. </para> <programlisting role="php"> <![CDATA[ <?php $sth = $dbh->prepare("SELECT name, colour FROM fruit"); $sth->execute(); /* Récupération de toutes les valeurs de la première colonne */ $result = $sth->fetchAll(PDO::FETCH_COLUMN, 0); var_dump($result); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Array(3) ( [0] => string(5) => apple [1] => string(4) => pear [2] => string(10) => watermelon ) ]]> </screen> </example> <example> <title>Grouper toutes les valeurs d'une seule colonne</title> <para> L'exemple suivant montre comment retourner un tableau associatif groupé par les valeurs de la colonne spécifiée d'un jeu de résultats. Le tableau contient trois clés : les valeurs <literal>apple</literal> et <literal>pear</literal> sont retournées sous la forme de tableaux qui contiennent deux couleurs différentes, tandis que <literal>watermelon</literal> est retourné sous la forme d'un tableau qui contient uniquement une seule couleur. </para> <programlisting role="php"> <![CDATA[ <?php $insert = $dbh->prepare("INSERT INTO fruit(name, colour) VALUES (?, ?)"); $insert->execute('apple', 'green'); $insert->execute('pear', 'yellow'); $sth = $dbh->prepare("SELECT name, colour FROM fruit"); $sth->execute(); /* Grouper les valeurs de la première colonne */ var_dump($sth->fetchAll(PDO::FETCH_COLUMN|PDO::FETCH_GROUP)); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array(3) { ["apple"]=> array(2) { [0]=> string(5) "green" [1]=> string(3) "red" } ["pear"]=> array(2) { [0]=> string(5) "green" [1]=> string(6) "yellow" } ["watermelon"]=> array(1) { [0]=> string(5) "green" } } ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-query" /></member> <member><xref linkend="function.PDOStatement-fetch" /></member> <member><xref linkend="function.PDOStatement-fetchColumn" /></member> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-setFetchMode" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/fetchcolumn.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/fetchcolumn.xml +++ phpdoc-fr/reference/pdo/pdostatement/fetchcolumn.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-fetchColumn" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->fetchColumn()</refname> <refpurpose> Retourne une colonne depuis la ligne suivante d'un jeu de résultats </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>string</type><methodname>fetchColumn</methodname> <methodparam choice="opt"><type>int</type><parameter>column_number</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Retourne une colonne depuis la ligne suivante d'un jeu de résultats ou &false; s'il n'y a plus de ligne. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>column_number</parameter></term> <listitem> <para> Numéro de la colonne que vous voulez récupérer depuis la ligne (commençant à 0). Si aucune valeur n'est fournie, <xref linkend="function.PDOStatement-fetchColumn" /> récupérera la première colonne. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDOStatement-fetchColumn" /> retourne une colonne depuis la ligne suivante d'un jeu de résultats. </para> <warning> <para> Il n'y a pas de solution pour retourner une autre colonne depuis la même ligne si vous utilisez la fonction <xref linkend="function.PDOStatement-fetchColumn" /> pour récupérer les données. </para> </warning> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Retourne la première colonne de la ligne suivante</title> <programlisting role="php"> <![CDATA[ <?php $sth = $dbh->prepare("SELECT nom, couleur FROM fruit"); $sth->execute(); /* Récupère la première colonne depuis la ligne suivante d'un jeu de résultats */ print("Récupère la première colonne depuis la ligne suivante d'un jeu de résultats :\n"); $result = $sth->fetchColumn(); print("nom=$result\n"); print("Récupère la deuxième colonne depuis la ligne suivante d'un jeu de résultats :\n"); $result = $sth->fetchColumn(); print("couleur=$result\n"); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Récupère la première colonne depuis la ligne suivante d'un jeu de résultats : nom=lemon Récupère la deuxième colonne depuis la ligne suivante d'un jeu de résultats : couleur=orange ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-query" /></member> <member><xref linkend="function.PDOStatement-fetch" /></member> <member><xref linkend="function.PDOStatement-fetchAll" /></member> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-setFetchMode" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/fetchobject.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/fetchobject.xml +++ phpdoc-fr/reference/pdo/pdostatement/fetchobject.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-fetchObject" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->fetchObject()</refname> <refpurpose>Récupère la prochaine ligne et la retourne en tant qu'objet</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>mixed</type><methodname>fetchObject</methodname> <methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>ctor_args</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Récupère la prochaine ligne et la retourne en tant qu'objet. Cette fonction est une alternative à <xref linkend="function.PDOStatement-fetch" /> avec <constant>PDO::FETCH_CLASS</constant> ou le style <constant>PDO::FETCH_OBJ</constant>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>class_name</parameter></term> <listitem> <para> Nom de la classe créée, la valeur par défaut est <literal>stdClass</literal>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>ctor_args</parameter></term> <listitem> <para> Éléments de ce tableau sont passés au constructeur. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne une instance de la classe demandée avec les propriétés de noms qui correspondent aux noms des colonnes ou &false; en cas d'une erreur. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDOStatement-fetch" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/getattribute.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/getattribute.xml +++ phpdoc-fr/reference/pdo/pdostatement/getattribute.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-getAttribute" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->getAttribute()</refname> <refpurpose> Récupère un attribut de requête </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>mixed</type><methodname>getAttribute</methodname> <methodparam><type>int</type><parameter>attribute</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Récupère un attribut de la requête. Actuellement, aucun attribut générique n'existe, mais uniquement des spécificités du driver : <itemizedlist> <listitem><para><literal>PDO::ATTR_CURSOR_NAME</literal> (spécificité de Firebird et d'ODBC) : Récupère le nom du curseur pour <literal>UPDATE ... WHERE CURRENT OF</literal>. </para></listitem> </itemizedlist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la valeur de l'attribut. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-getAttribute" /></member> <member><xref linkend="function.PDO-setAttribute" /></member> <member><xref linkend="function.PDOStatement-setAttribute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/getcolumnmeta.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/getcolumnmeta.xml +++ phpdoc-fr/reference/pdo/pdostatement/getcolumnmeta.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-getColumnMeta" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->getColumnMeta()</refname> <refpurpose> Retourne les métadonnées pour une colonne d'un jeu de résultats </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>mixed</type><methodname>getColumnMeta</methodname> <methodparam><type>int</type><parameter>column</parameter></methodparam> </methodsynopsis> </classsynopsis> &warn.undocumented.func; <para> Récupère les metainformations pour une colonne d'un jeu de résultat dans un tableau associatif. </para> <warning> <simpara> Tous les drivers PDO ne supportent pas la fonction <xref linkend="function.PDOStatement-getColumnMeta" />. </simpara> </warning> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>column</parameter></term> <listitem> <para> Le nom de la colonne dans le jeu de résultat. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne un tableau associatif contenant les valeurs suivantes représentant les metainformations pour une colonne : </para> <table> <title>Metainformations d'une colonne</title> <tgroup cols='2'> <colspec colname='c1'/> <colspec colname='c2'/> <thead> <row> <entry>Nom</entry> <entry>Valeur</entry> </row> </thead> <tbody> <row> <entry><literal>native_type</literal></entry> <entry>Le type natif PHP utilisé pour représenter la valeur de la colonne.</entry> </row> <row> <entry><literal>driver:decl_type</literal></entry> <entry>Le type SQL utilisé pour représenter la valeur de la colonne dans la base de données. Si la colonne du jeu de résultat est le résultat d'une fonction, cette valeur n'est pas retournée par la fonction <xref linkend="function.PDOStatement-getColumnMeta" />. </entry> </row> <row> <entry><literal>flags</literal></entry> <entry>N'importe quelle balise définie pour cette colonne.</entry> </row> <row> <entry><literal>name</literal></entry> <entry>Le nom de cette colonne, comme retourné par la base de données.</entry> </row> <row> <entry><literal>len</literal></entry> <entry>La longueur de cette colonne. Normalement, <literal>-1</literal> pour les types autres que les nombres décimaux à virgule flottante.</entry> </row> <row> <entry><literal>precision</literal></entry> <entry>La précision numérique pour cette colonne. Normalement, &zero; pour les types autres que les nombres décimaux à virgule flottante.</entry> </row> <row> <entry><literal>pdo_type</literal></entry> <entry>Le type de cette colonne comme représenté par la constante <literal>PDO::PARAM_*</literal> constants.</entry> </row> </tbody> </tgroup> </table> <para> Retourne &false; si la colonne demandée n'existe pas dans le jeu de résultats, ou si aucun jeu de résultats n'existe. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Récupération des metainformations pour une colonne</title> <para> L'exemple suivant montre le résultat de la récupération des metainformations pour une colonne générée par une fonction (COUNT) dans un pilote PDO_SQLITE. </para> <programlisting role="php"> <![CDATA[ <?php $select = $DB->query('SELECT COUNT(*) FROM fruit'); $meta = $select->getColumnMeta(0); var_dump($meta); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array(6) { ["native_type"]=> string(7) "integer" ["flags"]=> array(0) { } ["name"]=> string(8) "COUNT(*)" ["len"]=> int(-1) ["precision"]=> int(0) ["pdo_type"]=> int(2) } ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDOStatement-columnCount" /></member> <member><xref linkend="function.PDOStatement-rowCount" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/nextrowset.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/nextrowset.xml +++ phpdoc-fr/reference/pdo/pdostatement/nextrowset.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-nextRowset" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->nextRowset()</refname> <refpurpose> Avance à la prochaine ligne de résultats d'un gestionnaire de lignes de résultats multiples </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>nextRowset</methodname> <void/> </methodsynopsis> </classsynopsis> <para> Quelques bases de données supportent les procédures stockées qui retournent plus d'une ligne de résultats (aussi connu comme des jeux de résultats). <xref linkend="function.PDOStatement-nextRowset" /> vous permet d'accéder à la seconde et suivantes lignes de résultats associées avec l'objet PDOStatement. Chaque ligne de résultats a des jeux différents de colonnes depuis la ligne de résultats. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Récupération de multiples lignes de résultats retournées par une procédure stockée</title> <para> L'exemple suivant montre comment appeler une procédure stockée, MULTIPLE_RESULTS, qui retourne trois lignes de résultats. Nous utilisons une boucle do / while pour parcourir la méthode <xref linkend="function.PDOStatement-nextRowset" />, qui retourne &false; et termine la boucle lorsque plus aucune ligne de résultats ne peut être retournée. </para> <programlisting role="php"> <![CDATA[ <?php $sql = 'CALL multiple_rowsets()'; $stmt = $conn->query($sql); $i = 1; do { $rowset = $stmt->fetchAll(PDO::FETCH_NUM); if ($rowset) { printResultSet($rowset, $i); } $i++; } while ($stmt->nextRowset()); function printResultSet(&$rowset, $i) { print "Jeu de résultats $i:\n"; foreach ($rowset as $row) { foreach ($row as $col) { print $col . "\t"; } print "\n"; } print "\n"; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Jeu de résultats 1: apple red banana yellow Jeu de résultats 2: orange orange 150 banana yellow 175 Jeu de résultats 3: lime green apple red banana yellow ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDOStatement-columnCount" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> <member><xref linkend="function.PDOStatement-getColumnMeta" /></member> <member><xref linkend="function.PDO-query" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/rowcount.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/rowcount.xml +++ phpdoc-fr/reference/pdo/pdostatement/rowcount.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-rowCount" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->rowCount()</refname> <refpurpose> Retourne le nombre de lignes affectées par le dernier appel à la fonction PDOStatement::execute() </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>int</type><methodname>rowCount</methodname> <void/> </methodsynopsis> </classsynopsis> <para> <xref linkend="function.PDOStatement-rowCount" /> retourne le nombre de lignes affectées par la dernière requête DELETE, INSERT ou UPDATE exécutée par l'objet <literal>PDOStatement</literal> correspondant. </para> <para> Si la dernière requête SQL exécutée par l'objet <literal>PDOStatement</literal> associé est une requête de type SELECT, quelques bases de données retourneront le nombre de lignes retournées par cette requête. Néanmoins, ce comportement n'est pas garanti pour toutes les bases de données et ne devrait pas être exécuté pour des applications portables. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Retourne le nombre de lignes effacées</title> <para> <xref linkend="function.PDOStatement-rowCount" /> retourne le nombre de lignes affectées par une requête DELETE, INSERT, ou UPDATE. </para> <programlisting role="php"> <![CDATA[ <?php /* Effacement de toutes les lignes de la table FRUIT */ $del = $dbh->prepare('DELETE FROM fruit'); $del->execute(); /* Retourne le nombre de lignes effacées */ print("Retourne le nombre de lignes effacées :\n"); $count = $del->rowCount(); print("Effacement de $count lignes.\n"); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Effacement de 9 lignes. ]]> </screen> </example> <example> <title>Comptage des lignes retournées par une requête SELECT</title> <para> Pour la plupart des bases de données, <xref linkend="function.PDOStatement-rowCount" /> ne retourne pas le nombre de lignes affectées par une requête SELECT. À la place, utilisez <xref linkend="function.PDO-query" /> pour faire une requête SELECT COUNT(*), puis utilisez <xref linkend="function.PDOStatement-fetchColumn" /> pour récupérer le nombre de lignes retournées. Votre application peut ainsi effectuer la bonne action. </para> <programlisting role="php"> <![CDATA[ <?php $sql = "SELECT COUNT(*) FROM fruit WHERE calories > 100"; if ($res = $conn->query($sql)) { /* Récupère le nombre de lignes qui correspond à la requête SELECT */ if ($res->fetchColumn() > 0) { /* Effectue la vraie requête SELECT et travaille sur le résultat */ $sql = "SELECT nom FROM fruit WHERE calories > 100"; foreach ($conn->query($sql) as $row) { print "Nom : " . $row['NOM'] . "\n"; } } /* Aucune ligne ne correspond -- faire quelque chose d'autre */ else { print "Aucune ligne ne correspond à la requête."; } } $res = null; $conn = null; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ apple banana orange pear ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDOStatement-columnCount" /></member> <member><xref linkend="function.PDOStatement-fetchColumn" /></member> <member><xref linkend="function.PDO-query" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/setattribute.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/setattribute.xml +++ phpdoc-fr/reference/pdo/pdostatement/setattribute.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-setAttribute" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->setAttribute()</refname> <refpurpose> Définie un attribut de requête </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>setAttribute</methodname> <methodparam><type>int</type><parameter>attribute</parameter></methodparam> <methodparam><type>mixed</type><parameter>value</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Définit un attribut de la requête. Actuellement, aucun attribut générique n'est défini, mais uniquement des spécificités du driver : <itemizedlist> <listitem><para><literal>PDO::ATTR_CURSOR_NAME</literal> (spécificité de Firebird et d'ODBC) : Définit le nom du curseur pour <literal>UPDATE ... WHERE CURRENT OF</literal>. </para></listitem> </itemizedlist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-getAttribute" /></member> <member><xref linkend="function.PDO-setAttribute" /></member> <member><xref linkend="function.PDOStatement-getAttribute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/setfetchmode.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/setfetchmode.xml +++ phpdoc-fr/reference/pdo/pdostatement/setfetchmode.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-setFetchMode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->setFetchMode()</refname> <refpurpose> Définit le mode de récupération par défaut pour cette requête </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>setFetchMode</methodname> <methodparam><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> </classsynopsis> <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>setFetchMode</methodname> <methodparam><type>int</type><parameter>PDO::FETCH_COLUMN</parameter></methodparam> <methodparam><type>int</type><parameter>colno</parameter></methodparam> </methodsynopsis> </classsynopsis> <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>setFetchMode</methodname> <methodparam><type>int</type><parameter>PDO::FETCH_CLASS</parameter></methodparam> <methodparam><type>string</type><parameter>classname</parameter></methodparam> <methodparam><type>array</type><parameter>ctorargs</parameter></methodparam> </methodsynopsis> </classsynopsis> <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>setFetchMode</methodname> <methodparam><type>int</type><parameter>PDO::FETCH_INTO</parameter></methodparam> <methodparam><type>object</type><parameter>object</parameter></methodparam> </methodsynopsis> </classsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>mode</parameter></term> <listitem> <para> Le mode de récupération doit être une des constantes <literal>PDO::FETCH_*</literal>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne &one; en cas de succès ou &false; si une erreur survient. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Définition du mode de récupération</title> <para> L'exemple suivant montre comment <xref linkend="function.PDOStatement-setFetchMode" /> modifie le mode de récupération par défaut pour un objet PDOStatement. </para> <programlisting role="php"> <![CDATA[ <?php $sql = 'SELECT name, colour, calories FROM fruit'; try { $stmt = $dbh->query($sql); $result = $stmt->setFetchMode(PDO::FETCH_NUM); while ($row = $stmt->fetch()) { print $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n"; } } catch (PDOException $e) { print $e->getMessage(); } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ apple red 150 banana yellow 250 orange orange 300 kiwi brown 75 lemon yellow 25 pear green 150 watermelon pink 90 ]]> </screen> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/begintransaction.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/begintransaction.xml +++ phpdoc-fr/reference/pdo/pdo/begintransaction.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-beginTransaction" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->beginTransaction()</refname> <refpurpose> Démarre une transaction </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>beginTransaction</methodname> <void/> </methodsynopsis> </classsynopsis> <para> <function>PDO::beginTransaction</function> désactive le mode <literal>autocommit</literal>. Lorsque l'autocommit est désactivé, les modifications faites sur la base de données via les instances des objets PDO ne sont pas appliquées tant que vous ne mettez pas fin à la transaction en appelant la fonction <xref linkend="function.PDO-commit" />. L'appel de <xref linkend="function.PDO-rollBack" /> annulera toutes les modifications faites à la base de données et remettra la connexion en mode autocommit. </para> <para> Quelques bases de données, dont MySQL, exécuteront automatiquement un COMMIT lorsqu'une requête de définition de langage de base de données (DDL) comme DROP TABLE ou CREATE TABLE est exécutée dans une transaction. Ce COMMIT implicite vous empêchera d'annuler toutes autres modifications faites dans cette transaction. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Annule une transaction</title> <para> L'exemple suivant commence une transaction et exécute deux requêtes qui modifient la base de données avant d'annuler les modifications. Sur MySQL, cependant, la requête DROP TABLE validera automatiquement la transaction, donc, aucune des modifications de la transaction ne sera annulée. </para> <programlisting role='php'> <![CDATA[ <?php /* Démarre une transaction, désactivation de l'auto-commit */ $dbh->beginTransaction(); /* Modification du schéma de la base ainsi que des données */ $sth = $dbh->exec("DROP TABLE fruit"); $sth = $dbh->exec("UPDATE dessert SET name = 'hamburger'"); /* On s'aperçoit d'une erreur et on annule les modifications */ $dbh->rollBack(); /* Le connexion à la base de données est maintenant de retour en mode auto-commit */ ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-commit" /></member> <member><xref linkend="function.PDO-rollBack" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/commit.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/commit.xml +++ phpdoc-fr/reference/pdo/pdo/commit.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-commit" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->commit()</refname> <refpurpose> Valide une transaction </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>commit</methodname> <void/> </methodsynopsis> </classsynopsis> <para> <function>PDO::commit</function> valide une transaction, remet la connexion en mode <literal>autocommit</literal> en attendant l'appel à la fonction <xref linkend="function.PDO-beginTransaction" /> pour débuter une nouvelle transaction. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Valide une transaction</title> <programlisting role='php'> <![CDATA[ <?php /* Commence une transaction, désactivation de l'auto-commit */ $dbh->beginTransaction(); /* Modification du schéma de la base de données */ $sth = $dbh->exec("DROP TABLE fruit"); /* Valide les modifications */ $dbh->commit(); /* La connexion à la base de données est maintenant de retour en mode auto-commit */ ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-beginTransaction" /></member> <member><xref linkend="function.PDO-rollBack" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/errorcode.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/errorcode.xml +++ phpdoc-fr/reference/pdo/pdo/errorcode.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-errorCode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->errorCode()</refname> <refpurpose> Retourne le SQLSTATE associé avec la dernière opération sur la base de données </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>string</type><methodname>errorCode</methodname> <void/> </methodsynopsis> </classsynopsis> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDO-errorCode" /> retourne un SQLSTATE, un identifiant alphanumérique de cinq caractères défini dans le standard AINSI SQL. Brièvement, un SQLSTATE consiste en une valeur de classe de deux caractères suivi par une valeur de sous-classe de trois caractères. Une valeur de classe de 01 indique une alerte et est accompagnée par un code de retour SQL_SUCCESS_WITH_INFO. Les valeurs de classes autre que '01', mis à part la classe 'IM', indiquent une erreur. La classe 'IM' est spécifique aux alertes et aux erreurs qui sont issus de l'implémentation elle-même de PDO (ou peut-être ODBC, si vous utilisez le driver ODBC). La valeur de sous-classe '000' dans n'importe quelle classe, indique qu'il n'y a pas de sous-classe pour cet SQLSTATE. </para> <para> <xref linkend="function.PDO-errorCode" /> retourne uniquement les codes erreurs pour les opérations exécutées directement sur le gestionnaire de la base de données. Si vous créez un objet PDOStatement avec la fonction <xref linkend="function.PDO-prepare" /> ou la fonction <xref linkend="function.PDO-query" /> et que vous invoquez une erreur sur le gestionnaire de requête, <xref linkend="function.PDO-errorCode" /> ne retournera pas cette erreur. Vous devez appeler <xref linkend="function.PDOStatement-errorCode" /> pour retourner le code erreur pour une opération exécutée sur un gestionnaire de requête particulier. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Récupération d'un code SQLSTATE</title> <programlisting role="php"> <![CDATA[ <?php /* Provoque une erreur -- la table BONES n'existe pas */ $dbh->exec("INSERT INTO bones(skull) VALUES ('lucy')"); echo "\nPDO::errorCode(): "; print $dbh->errorCode(); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ PDO::errorCode(): 42S02 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-errorInfo" /></member> <member><xref linkend="function.PDOStatement-errorCode" /></member> <member><xref linkend="function.PDOStatement-errorInfo" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/errorinfo.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/errorinfo.xml +++ phpdoc-fr/reference/pdo/pdo/errorinfo.xml <?xml version='1.0' encoding='utf-8'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-errorInfo" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->errorInfo()</refname> <refpurpose> Retourne les informations associées à l'erreur lors de la dernière opération sur la base de données </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>array</type><methodname>errorInfo</methodname> <void/> </methodsynopsis> </classsynopsis> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDO-errorInfo" /> retourne un tableau contenant des informations sur l'erreur survenu lors de la dernière opération exécutée par ce gestionnaire de base de données. Le tableau contient les champs suivants : <informaltable> <tgroup cols='2'> <thead> <row> <entry>Ãlément</entry> <entry>Information</entry> </row> </thead> <tbody> <row> <entry>0</entry> <entry>code erreur SQLSTATE (un identifiant alphanumérique de cinq caractères défini dans le standard ANSI SQL).</entry> </row> <row> <entry>1</entry> <entry>Code erreur spécifique au driver.</entry> </row> <row> <entry>2</entry> <entry>Message d'erreur spécifique au driver.</entry> </row> </tbody> </tgroup> </informaltable> </para> <para> <xref linkend="function.PDO-errorInfo" /> retourne uniquement les informations des erreurs pour les opérations exécutées directement sur un gestionnaire de base de données. Si vous créez un objet PDOStatement avec la fonction <xref linkend="function.PDO-prepare" /> ou la fonction <xref linkend="function.PDO-query" /> et que vous invoquez une erreur sur le gestionnaire de requête, <xref linkend="function.PDO-errorInfo" /> ne retournera pas l'erreur depuis le gestionnaire de requête. Vous devez appeler la fonction <xref linkend="function.PDOStatement-errorInfo" /> pour retourner les informations sur l'erreur pour une opération exécutée sur un gestionnaire de requête particulier. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Affiche les champs de errorInfo() pour une connexion PDO_ODBC sur une base de donnés DB2</title> <programlisting role="php"> <![CDATA[ <?php /* Provoque une erreur -- mauvaise syntaxe SQL */ $stmt = $dbh->prepare('mauvaise syntaxe sql'); if (!$stmt) { echo "\nPDO::errorInfo():\n"; print_r($dbh->errorInfo()); } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ PDO::errorInfo(): Array ( [0] => 42S02 [1] => -204 [2] => [IBM][CLI Driver][DB2/LINUX] SQL0204N "DANIELS.BONES" is an undefined name. SQLSTATE=42704 ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-errorCode" /></member> <member><xref linkend="function.PDOStatement-errorCode" /></member> <member><xref linkend="function.PDOStatement-errorInfo" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/exec.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/exec.xml +++ phpdoc-fr/reference/pdo/pdo/exec.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-exec" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->exec()</refname> <refpurpose> Exécute une requête SQL et retourne le nombre de lignes affectées </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>int</type><methodname>exec</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <xref linkend="function.PDO-exec" /> exécute une requête SQL dans un appel d'une seule fonction, retourne le nombre de lignes affectées par la requête. </para> <para> <xref linkend="function.PDO-exec" /> ne retourne pas de résultat pour une requête SELECT. Pour une requête SELECT dont vous auriez besoin une seule fois dans le programme, utilisez plutôt la fonction <xref linkend="function.PDO-query" />. Pour une requête dont vous auriez besoin plusieurs fois, préparez un objet PDOStatement avec la fonction <xref linkend="function.PDO-prepare" /> et exécutez la requête avec la fonction <xref linkend="function.PDOStatement-execute" />. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>statement</parameter></term> <listitem> <para> La requête à préparer et à exécuter. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDO-exec" /> retourne le nombre de lignes qui ont été modifiées ou effacées pour la requête SQL qui vous exécutez. Si aucune ligne n'est affectée, la fonction <xref linkend="function.PDO-exec" /> retournera &zero;. </para> &return.falseproblem; <para> L'exemple suivant se fonde inexactement sur la valeur retournée par <xref linkend="function.PDO-exec" />, où une requête qui n'affecte aucune lignes revient à appeler <function>die</function> : <programlisting role="php"> <![CDATA[ <?php $db->exec() or die($db->errorInfo()); ?> ]]> </programlisting> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exécution d'une requête DELETE</title> <para> Compte le nombre de lignes effacées pour une requête DELETE avec aucune clause WHERE. </para> <programlisting role="php"> <![CDATA[ <?php $dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2'); /* Effacement de toutes les lignes de la table FRUIT */ $count = $dbh->exec("DELETE FROM fruit WHERE couleur = 'rouge'"); /* Retourne le nombre de lignes effacées */ print("Retourne le nombre de lignes effacées :\n"); print("Effacement de $count lignes.\n"); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Retourne le nombre de lignes effacées : Effacement de 2 lignes. ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDO-query" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/getattribute.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/getattribute.xml +++ phpdoc-fr/reference/pdo/pdo/getattribute.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-getAttribute" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->getAttribute()</refname> <refpurpose> Récupère un attribut d'une connexion à une base de données </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>mixed</type><methodname>getAttribute</methodname> <methodparam><type>int</type><parameter>attribute</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Cette fonction retourne la valeur d'un attribut d'une connexion à une base de données. Pour récupérer les attributs PDOStatement, référez-vous à la fonction <xref linkend="function.PDOStatement-getAttribute" />. </para> <para> Notez que quelques bases de données/drivers combinés ne supportent pas tous les attributs de connexion. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>attribute</parameter></term> <listitem> <para> Une des constantes <literal>PDO::ATTR_*</literal>. Les constantes qui sont appliquées aux connexions sont les suivantes : <simplelist> <member><literal>PDO::ATTR_AUTOCOMMIT</literal></member> <member><literal>PDO::ATTR_CASE</literal></member> <member><literal>PDO::ATTR_CLIENT_VERSION</literal></member> <member><literal>PDO::ATTR_CONNECTION_STATUS</literal></member> <member><literal>PDO::ATTR_DRIVER_NAME</literal></member> <member><literal>PDO::ATTR_ERRMODE</literal></member> <member><literal>PDO::ATTR_ORACLE_NULLS</literal></member> <member><literal>PDO::ATTR_PERSISTENT</literal></member> <member><literal>PDO::ATTR_PREFETCH</literal></member> <member><literal>PDO::ATTR_SERVER_INFO</literal></member> <member><literal>PDO::ATTR_SERVER_VERSION</literal></member> <member><literal>PDO::ATTR_TIMEOUT</literal></member> </simplelist> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Un appel réussi retourne la valeur de l'attribut PDO demandé. Un appel qui a échoué retourne la valeur <literal>null</literal>. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Récupération des attributs de connexion à une base de données</title> <programlisting role="php"> <![CDATA[ <?php $conn = new PDO('odbc:sample', 'db2inst1', 'ibmdb2'); $attributes = array( "AUTOCOMMIT", "ERRMODE", "CASE", "CLIENT_VERSION", "CONNECTION_STATUS", "ORACLE_NULLS", "PERSISTENT", "PREFETCH", "SERVER_INFO", "SERVER_VERSION", "TIMEOUT" ); foreach ($attributes as $val) { echo "PDO::ATTR_$val: "; echo $conn->getAttribute(constant("PDO::ATTR_$val")) . "\n"; } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-setAttribute" /></member> <member><xref linkend="function.PDOStatement-getAttribute" /></member> <member><xref linkend="function.PDOStatement-setAttribute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/lastinsertid.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/lastinsertid.xml +++ phpdoc-fr/reference/pdo/pdo/lastinsertid.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-lastInsertId" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->lastInsertId()</refname> <refpurpose> Retourne l'identifiant de la dernière ligne insérée ou la valeur d'une séquence </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>string</type><methodname>lastInsertId</methodname> <methodparam choice="opt"><type>string</type><parameter>name</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Retourne l'identifiant de la dernière ligne insérée, ou la dernière valeur d'une séquence d'objets, dépendamment du driver utilisé. Par exemple, <function>PDO_PGSQL</function> vous impose de spécifier le nom d'une séquence d'objet pour le paramètre <parameter>name</parameter>. </para> <note> <para> Cette méthode peut ne pas retourner un résultat significatif suivant les drivers PDO utilisés, car la base de données utilisée peut ne pas supporter la notion de champs auto-incrémenté ou de séquences. </para> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>name</parameter></term> <listitem> <para> Nom de la séquence d'objets depuis laquelle l'identifiant doit être retourné. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Si un nom de séquence n'est pas spécifié pour le paramètre <parameter>name</parameter>, <xref linkend="function.PDO-lastInsertId" /> retourne une chaîne représentant l'identifiant de la ligne de la dernière ligne insérée dans la base de données. </para> <para> Si un nom de séquence est spécifié pour le paramètre <parameter>name</parameter>, <xref linkend="function.PDO-lastInsertId" /> retourne une chaîne représentant la dernière valeur depuis la séquence d'objets spécifiée. </para> <para> Si le driver PDO ne supporte pas cette fonctionnalité, <xref linkend="function.PDO-lastInsertId" /> lancera un SQLSTATE <literal>IM001</literal>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/prepare.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/prepare.xml +++ phpdoc-fr/reference/pdo/pdo/prepare.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-prepare" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->prepare()</refname> <refpurpose> Prépare une requête à l'exécution et retourne un objet </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>PDOStatement</type><methodname>prepare</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>driver_options</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Prépare une requête SQL à être exécutée par la méthode <xref linkend="function.PDOStatement-execute" />. La requête SQL peut contenir zéro ou plusieurs noms (:name) ou marqueurs (?) pour lesquels les valeurs réelles seront substituées lorsque la requête sera exécutée. Vous ne pouvez pas utiliser les marqueurs nommés et les marqueurs interrogatifs dans une même requête SQL ; choisissez l'un ou l'autre. </para> <para> Vous devez inclure un marquer avec un nom unique pour chaque valeur que vous souhaitez passer dans la requête lorsque vous appelez <xref linkend="function.PDOStatement-execute" />. Vous ne pouvez pas utiliser un marqueur avec deux noms pareils dans une requête préparée. Vous ne pouvez associer plusieurs valeurs à un seul marqueur de nom entrant, par exemple, la clause IN() d'une requête SQL. </para> <para> Appeler <xref linkend="function.PDO-prepare" /> et <xref linkend="function.PDOStatement-execute" /> pour les requêtes qui doivent être exécutées plusieurs fois avec différentes valeurs de paramètres optimisent les performances de votre application en autorisant le driver à négocier coté client et/ou serveur avec le cache des requêtes et les métainformations, et aident à prévenir les attaques par injection SQL en éliminant le besoin de protéger les paramètres manuellement. </para> <para> PDO émulera les requêtes préparées / les paramètres liés pour les drivers qui ne le supportent pas nativement, et peut également réécrire les paramètres nommés ou les marqueurs en quelques choses de plus approprié, si le driver supporte un style mais pas l'autre. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>statement</parameter></term> <listitem> <para> Doit être une requête SQL valide pour le serveur de base de données cible. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>driver_options</parameter></term> <listitem> <para> Ce tableau contient une ou plusieurs paires clé=>valeur pour définir les valeurs des attributs pour l'objet PDOStatement que cette méthode retourne. Vous pouvez utiliser ceci pour définir la valeur <literal>PDO::ATTR_CURSOR</literal> à <literal>PDO::CURSOR_SCROLL</literal> pour demander un curseur scrollable. Quelques drivers ont des options spécifiques qui peuvent être définies au moment de la préparation. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Si le serveur de base de données prépare avec succès cette requête, <xref linkend="function.PDO-prepare" /> retourne un objet PDOStatement. Si le serveur de base de données ne réussit pas à préparer la requête, <xref linkend="function.PDO-prepare" /> retourne &false;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Prépare une requête SQL avec des paramètres nommés</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en passant un tableau de valeurs */ $sql = 'SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'; $sth = $dbh->prepare($sql, array(PDO::ATTR_CURSOR => PDO::CURSOR_FWDONLY)); $sth->execute(array(':calories' => 150, ':couleur' => 'red')); $red = $sth->fetchAll(); $sth->execute(array('calories' => 175, 'couleur' => 'yellow')); $yellow = $sth->fetchAll(); ?> ]]> </programlisting> </example> <example> <title>Prépare une requête SQL avec des marqueurs</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en passant un tableau de valeurs */ $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); $sth->execute(array(150, 'rouge')); $red = $sth->fetchAll(); $sth->execute(array(175, 'jaune')); $yellow = $sth->fetchAll(); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-exec" /></member> <member><xref linkend="function.PDO-query" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/query.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/query.xml +++ phpdoc-fr/reference/pdo/pdo/query.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-query" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->query()</refname> <refpurpose> Exécute une requête SQL, retourne un jeu de résultats en tant qu'objet PDOStatement </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>PDOStatement</type><methodname>query</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> </methodsynopsis> </classsynopsis> <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>query</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> <methodparam><type>int</type><parameter>PDO::FETCH_COLUMN</parameter></methodparam> <methodparam><type>int</type><parameter>colno</parameter></methodparam> </methodsynopsis> </classsynopsis> <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>query</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> <methodparam><type>int</type><parameter>PDO::FETCH_CLASS</parameter></methodparam> <methodparam><type>string</type><parameter>classname</parameter></methodparam> <methodparam><type>array</type><parameter>ctorargs</parameter></methodparam> </methodsynopsis> </classsynopsis> <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>query</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> <methodparam><type>int</type><parameter>PDO::FETCH_INTO</parameter></methodparam> <methodparam><type>object</type><parameter>object</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <xref linkend="function.PDO-query" /> exécute une requête SQL en appelant une seule fonction, retourne le jeu de résultats (s'il y en a) retourné par la requête en tant qu'objet PDOStatement. </para> <para> Pour une requête que vous devez exécuter plusieurs fois, vous réaliserez de meilleurs performances si vous préparez l'objet PDOStatement en utilisant la fonction <xref linkend="function.PDO-prepare" /> et exécutez la requête via plusieurs appels à la fonction <xref linkend="function.PDOStatement-execute" />. </para> <para> Si vous ne récupérez pas toutes les données du jeux de résultats avant d'exécuter le prochain appel à <xref linkend="function.PDO-query" />, votre appel peut échouer. Appeler <xref linkend="function.PDOStatement-closeCursor" /> pour libérer les ressources de la base de données associées à l'objet PDOStatement avant d'exécuter votre prochain appel à la fonction <xref linkend="function.PDO-query" />. </para> <note> <para> Bien que la documentation de cette fonction autorise de passer un seul paramètre, vous pouvez y passer d'autres paramètres. Ils seront traités via l'appel à <xref linkend="function.PDOStatement-setFetchMode" /> sur le résultat du traitement de l'objet. </para> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>statement</parameter></term> <listitem> <para> La requête SQL à préparer et à exécuter. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDO-query" /> retourne un objet PDOStatement. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec PDO::query</title> <para> Une fonctionnalité intéressante de <xref linkend="function.PDO-query" /> est qu'il vous permet d'itérer à travers un jeu de résultats retourné par une requête SELECT exécutée avec succès. </para> <programlisting role="php"> <![CDATA[ <?php function getFruit($conn) { $sql = 'SELECT name, colour, calories FROM fruit ORDER BY name'; foreach ($conn->query($sql) as $row) { print $row['NAME'] . "\t"; print $row['COLOUR'] . "\t"; print $row['CALORIES'] . "\n"; } } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ apple red 150 banana yellow 250 kiwi brown 75 lemon yellow 25 orange orange 300 pear green 150 watermelon pink 90 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-exec" /></member> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/quote.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/quote.xml +++ phpdoc-fr/reference/pdo/pdo/quote.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-quote" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->quote()</refname> <refpurpose> Protège une chaîne pour l'utiliser dans une requête SQL PDO </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>string</type><methodname>quote</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>parameter_type</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <xref linkend="function.PDO-quote" /> place des guillemets simples autour d'une chaîne d'entrées (si nécessaire) et échappe les caractères spéciaux présents dans la chaîne d'entrées, en utilisant le style de protection approprié au driver courant. </para> <para> Si vous utilisez cette fonction pour construire des requêtes SQL, vous êtes <emphasis>vivement</emphasis> invité à utiliser <xref linkend="function.PDO-prepare" /> pour préparer les requêtes SQL avec des paramètres liées au lieu d'utiliser <xref linkend="function.PDO-quote" /> pour interpréter les entrées utilisateurs dans la requête SQL. Les requêtes préparées avec des paramètres liées ne sont pas seulement plus portables, plus malléables et plus sécurisées mais bien plus rapides à exécuter que d'interpréter les requêtes, étant donné que les côtés client et serveur peuvent mettre en cache une version compilée de la requête. </para> <para> Tous les drivers PDO n'implémentent pas cette méthode (comme PDO_ODBC). Utilisez les requêtes préparées à la place. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>string</parameter></term> <listitem> <para> La chaîne à échapper. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>parameter_type</parameter></term> <listitem> <para> Fournit un type de données pour les drivers qui ont des styles alternatifs d'échappement. La valeur par défaut est PDO::PARAM_STR. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne une chaîne échappée qui est théoriquement sûr à passer dans une requête SQL. Retourne &false; si le driver ne supporte pas la protection en ce sens. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Protection d'une chaîne normale</title> <programlisting role="php"> <![CDATA[ <?php $conn = new PDO('sqlite:/home/lynn/music.sql3'); /* Chaîne simple */ $string = 'Nice'; print "Chaîne non échappée : $string\n"; print "Chaîne échappée : " . $conn->quote($string) . "\n"; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Chaîne non échappée : Nice Chaîne échappée: 'Nice' ]]> </screen> </example> <example> <title>Echappement d'une chaîne dangereuse</title> <programlisting role="php"> <![CDATA[ <?php $conn = new PDO('sqlite:/home/lynn/music.sql3'); /* Chaîne dangereuse */ $string = 'Chaîne \' particulière'; print "Chaîne non échappée : $string\n"; print "Chaîne échappée :" . $conn->quote($string) . "\n"; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Chaîne non échappée : Chaîne ' particulière Chaîne échappée : 'Chaîne '' particulière' ]]> </screen> </example> <example> <title>Echappement d'une chaîne complexe</title> <programlisting role="php"> <![CDATA[ <?php $conn = new PDO('sqlite:/home/lynn/music.sql3'); /* Chaîne complexe */ $string = "Co'mpl''exe \"ch'\"aîne"; print "Chaîne non échappée: $string\n"; print "Chaîne échappée : " . $conn->quote($string) . "\n"; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Chaîne non échappée: Co'mpl''exe "ch'"aîne Chaîne échappée: 'Co''mpl''''exe "ch''"aîne' ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo/rollback.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdo/rollback.xml +++ phpdoc-fr/reference/pdo/pdo/rollback.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDO-rollBack" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDO->rollBack()</refname> <refpurpose> Annule une transaction </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDO</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>rollBack</methodname> <void/> </methodsynopsis> </classsynopsis> <para> Annule la transaction courante, initié par la fonction <xref linkend="function.PDO-beginTransaction" />. C'est une erreur que d'appeler cette méthode s'il n'y a aucune transaction active. </para> <para> Si la base de données est en mode autocommit, cette fonction restaurera le mode autocommit après l'annulation de la transaction. </para> <para> Quelques bases de données, dont MySQL, exécuteront automatiquement un COMMIT lorsqu'une requête de définition de langage de base de données (DDL) comme DROP TABLE ou CREATE TABLE est exécutée dans une transaction. Ce COMMIT implicite vous empêchera d'annuler toutes autres modifications faites dans cette transaction. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Annulation d'une transaction</title> <para> L'exemple suivant commence une transaction et exécute deux requêtes qui modifient la base de données avant d'annuler les modifications. Sur MySQL, cependant, la requête DROP TABLE validera automatiquement la transaction, donc, aucune des modifications de la transaction ne sera annulée. </para> <programlisting role='php'> <![CDATA[ <?php /* Début d'une transaction, désactivation du mode autocommit */ $dbh->beginTransaction(); /* Modifie le schéma de la base de données ainsi que des données */ $sth = $dbh->exec("DROP TABLE fruit"); $sth = $dbh->exec("UPDATE dessert SET name = 'hamburger'"); /* On s'aperçoit d'une erreur et on annule les modifications */ $dbh->rollBack(); /* La connexion à la base de donnés revient en mode autocommit */ ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-beginTransaction" /></member> <member><xref linkend="function.PDO-commit" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/bindcolumn.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/bindcolumn.xml +++ phpdoc-fr/reference/pdo/pdostatement/bindcolumn.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-bindColumn" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->bindColumn()</refname> <refpurpose> Lie une colonne à une variable PHP </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>bindColumn</methodname> <methodparam><type>mixed</type><parameter>column</parameter></methodparam> <methodparam><type>mixed</type><parameter role="reference">param</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <xref linkend="function.PDOStatement-bindColumn" /> fait en sorte qu'une variable particulière soit liée à une colonne données dans le jeu de résultats depuis une requête. Chaque appel à la fonction <xref linkend="function.PDOStatement-fetch" /> ou <xref linkend="function.PDOStatement-fetchAll" /> mettra à jour toutes les variables qui sont liées aux colonnes. </para> <note> <para> Étant donné que les informations sur les colonnes ne sont pas toujours disponibles à PDO tant que la requête n'est pas exécutée, les applications portables doivent appeler cette fonction <emphasis>après</emphasis> la fonction <xref linkend="function.PDOStatement-execute" />. </para> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>column</parameter></term> <listitem> <para> Numéro de la colonne (en commençant à 1) ou nom de la colonne dans le jeu de résultats. Si vous utilisez les noms de colonnes, assurez-vous que le nom corresponde à la casse de la colonne, comme retourné par le driver. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>param</parameter></term> <listitem> <para> Nom de la variable PHP à laquelle la colonne doit être liée. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>type</parameter></term> <listitem> <para> Type du paramètre, spécifié par les constantes PDO::PARAM_*. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Lie l'affichage du jeu de résultats à des variables PHP</title> <para> Lie les colonnes du jeu de résultats aux variables PHP est une façon agréable de rendre les données contenues dans chaque ligne immédiatement disponible à votre application. L'exemple suivant montre comment PDO vous autorise à lier et récupérer les colonnes avec une variété d'options. </para> <programlisting role="php"> <![CDATA[ <?php function readData($dbh) { $sql = 'SELECT nom, couleur, calories FROM fruit'; try { $stmt = $dbh->prepare($sql); $stmt->execute(); /* Lie par les numéros de colonnes */ $stmt->bindColumn(1, $nom); $stmt->bindColumn(2, $couleur); /* Lie par les noms de colonnes */ $stmt->bindColumn('calories', $cals); while ($row = $stmt->fetch(PDO::FETCH_BOUND)) { $data = $nom . "\t" . $couleur . "\t" . $cals . "\n"; print $data; } } catch (PDOException $e) { print $e->getMessage(); } } readData($dbh); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ pomme rouge 150 banane jaune 175 kiwi vert 75 orange orange 150 mangue rouge 200 fraise rouge 25 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDOStatement-execute" /></member> <member><xref linkend="function.PDOStatement-fetch" /></member> <member><xref linkend="function.PDOStatement-fetchAll" /></member> <member><xref linkend="function.PDOStatement-fetchColumn" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/bindparam.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/bindparam.xml +++ phpdoc-fr/reference/pdo/pdostatement/bindparam.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-bindParam" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->bindParam()</refname> <refpurpose> Lie un paramètre à un nom de variable spécifique </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>bindParam</methodname> <methodparam><type>mixed</type><parameter>parameter</parameter></methodparam> <methodparam><type>mixed</type><parameter role="reference">variable</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>data_type</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>driver_options</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Lie une variable PHP à un marquer nommé ou interrogatif correspondant dans une requête SQL utilisée pour préparer la requête. Contrairement à <xref linkend="function.PDOStatement-bindValue" />, la variable est liée en tant que référence et ne sera évaluée qu'au moment de l'appel à la fonction <xref linkend="function.PDOStatement-execute" />. </para> <para> La plupart des paramètres sont des paramètres d'entrées, et sont utilisés en lecture seule pour construire la requête. Quelques drivers supportent l'invocation de procédures stockées qui retournent des données en tant que paramètres de sortie, et quelques autres en tant que paramètres entrées / sorties qui sont envoyés ensemble et sont mis à jour pour les recevoir. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>parameter</parameter></term> <listitem> <para> Identifiant. Pour une requête préparée utilisant des marqueurs nommés, ce sera le nom du paramètre sous la forme <varname>:name</varname>. Pour une requête préparée utilisant les marqueurs interrogatifs, ce sera la position indexé -1 du paramètre. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>variable</parameter></term> <listitem> <para> Nom de la variable PHP à lier au paramètre de la requête SQL. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>data_type</parameter></term> <listitem> <para> Type explicite de données pour le paramètre utilisant la constante PDO::PARAM_*. Pour retourner un paramètre INOUT depuis une procédure stockée, utilisez l'opérateur OR pour définir l'octet PDO::PARAM_INPUT_OUTPUT pour le paramètre <parameter>data_type</parameter>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>length</parameter></term> <listitem> <para> Longueur du type de données. Pour indiquer qu'un paramètre est un paramètre OUT depuis une procédure stockée, vous devez explicitement définir la longueur. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>driver_options</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title> Exécution d'une requête préparée avec des emplacements nommés </title> <programlisting role='php'> <![CDATA[ <?php /* Exécution d'une requête préparée en liant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); $sth->bindParam(':calories', $calories, PDO::PARAM_INT); $sth->bindParam(':couleur', $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> </programlisting> </example> <example> <title> Exécution d'une requête préparée avec des marques de positionnement </title> <programlisting role='php'> <![CDATA[ <?php /* Exécution d'une requête préparée en liant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); $sth->bindParam(1, $calories, PDO::PARAM_INT); $sth->bindParam(2, $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> </programlisting> </example> <example> <title>Appel une procédure stockée avec un paramètre INOUT</title> <programlisting role='php'> <![CDATA[ <?php /* Appel une procédure stockée avec un paramètre INOUT */ $couleur = 'rouge'; $sth = $dbh->prepare('CALL puree_fruit(?)'); $sth->bindParam(1, $couleur, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 12); $sth->execute(); print("Après avoir pressé le fruit, la couleur est : $couleur"); ?> ]]> </programlisting> </example> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> <member><xref linkend="function.PDOStatement-bindValue" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/bindvalue.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/bindvalue.xml +++ phpdoc-fr/reference/pdo/pdostatement/bindvalue.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-bindValue" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->bindValue()</refname> <refpurpose> Associe une valeur à un paramètre </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>bindValue</methodname> <methodparam><type>mixed</type><parameter>parameter</parameter></methodparam> <methodparam><type>mixed</type><parameter>value</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>data_type</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Associe une valeur à un nom correspondant ou à un point d'interrogation (comme paramètre fictif) dans la requête SQL qui fut utilisée pour préparer la requête. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>parameter</parameter></term> <listitem> <para> Identifiant du paramètre. Pour une requête préparée utilisant les marqueurs, cela sera un nom de paramètre de la forme <varname>:nom</varname>. Pour une requête préparée utilisant les points d'interrogation (comme paramètre fictif), cela sera un tableau indexé numériquement qui commence à la position 1 du paramètre. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>value</parameter></term> <listitem> <para> La valeur à associer au paramètre. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>data_type</parameter></term> <listitem> <para> Type de données explicite pour le paramètre utilisant les constantes PDO::PARAM_*. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exécute une requête préparée avec des marqueurs nommés</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en associant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); $sth->bindValue(':calories', $calories, PDO::PARAM_INT); $sth->bindValue(':couleur', $couleur, PDO::PARAM_STR); $sth->execute(); ?> ]]> </programlisting> </example> <example> <title>Exécute une requête préparée avec des points d'interrogation comme paramètre fictif</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en associant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); $sth->bindValue(1, $calories, PDO::PARAM_INT); $sth->bindValue(2, $couleur, PDO::PARAM_STR); $sth->execute(); ?> ]]> </programlisting> </example> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> <member><xref linkend="function.PDOStatement-bindParam" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/closecursor.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/closecursor.xml +++ phpdoc-fr/reference/pdo/pdostatement/closecursor.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-closeCursor" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->closeCursor()</refname> <refpurpose> Ferme le curseur, permettant à la requête d'être de nouveau exécutée </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>closeCursor</methodname> <void/> </methodsynopsis> </classsynopsis> <para> <xref linkend="function.PDOStatement-closeCursor" /> libère la connexion du serveur, permettant ainsi à d'autres requêtes SQL d'être exécutées, mais quitte la requête, permettant ainsi qu'elle soit de nouveau exécutée. </para> <para> Cette méthode est utile pour les drivers de base de données qui ne supportent pas l'exécution d'objet PDOStatement lorsqu'un objet PDOStatement exécuté précédemment a encore des lignes non récupérées. Si votre driver de base de données souffre de cette limitation, le problème se manifestera de lui-même dans une erreur en dehors de la séquence. </para> <para> <xref linkend="function.PDOStatement-closeCursor" /> est implémenté soit en tant que méthode optionnelle spécifique au driver (autorisant un maximum d'efficacité), ou en tant que fallback PDO générique si aucune fonction spécifique au driver n'est installée. Le fallback générique PDO est sémantiquement la même chose que d'écrire le code suivant dans votre script PHP : <programlisting role="php"> <![CDATA[ <?php do { while ($stmt->fetch()) ; if (!$stmt->nextRowset()) break; } while (true); ?> ]]> </programlisting> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Exemple avec <xref linkend="function.PDOStatement-closeCursor" /></title> <para> Dans l'exemple suivant, l'objet PDOStatement <varname>$stmt</varname> retourne de multiples lignes mais l'application récupère uniquement la première ligne, laissant l'objet PDOStatement dans l'état où il lui reste des lignes non récupérées. Pour vous assurez que l'application fonctionnera avec tous les drivers de base de données, l'auteur insère un appel à la fonction <xref linkend="function.PDOStatement-closeCursor" /> sur <varname>$stmt</varname> avant l'exécution d'objet PDOStatement <varname>$otherStmt</varname>. </para> <programlisting role="php"> <![CDATA[ <?php /* Création d'un objet PDOStatement */ $stmt = $dbh->prepare('SELECT foo FROM bar'); /* Création d'un second objet PDOStatement */ $otherStmt = $dbh->prepare('SELECT foobaz FROM foobar'); /* Exécute la première requête */ $stmt->execute(); /* Récupération de la première ligne uniquement depuis le résultat */ $stmt->fetch(); /* L'appel suivant à closeCursor() peut être requis par quelques drivers */ $stmt->closeCursor(); /* Maintenant, nous pouvons exécuter la deuxième requête */ $otherStmt->execute(); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDOStatement-execute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/columncount.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/columncount.xml +++ phpdoc-fr/reference/pdo/pdostatement/columncount.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-columnCount" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->columnCount()</refname> <refpurpose> Retourne le nombre de colonnes dans le jeu de résultats </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>int</type><methodname>columnCount</methodname> <void/> </methodsynopsis> </classsynopsis> <para> Utilisez la fonction <xref linkend="function.PDOStatement-columnCount" /> pour retourner le nombre de colonnes dans le jeu de résultats représenté par l'objet PDOStatement. </para> <para> Si l'objet PDOStatement a été retourné par la fonction <xref linkend="function.PDO-query" />, le nombre de colonnes est immédiatement disponible. </para> <para> Si l'objet PDOStatement a été retourné par la fonction <xref linkend="function.PDO-prepare" />, un compte précis des colonnes ne sera pas disponible tant que vous n'invoquerez pas la fonction <xref linkend="function.PDOStatement-execute" />. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne le nombre de colonnes dans le jeu de résultats représenté par l'objet PDOStatement. S'il n'y a pas de jeu de résultats, <xref linkend="function.PDOStatement-columnCount" /> retournera &zero;. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Comptage des colonnes</title> <para> Cet exemple démontre comment <xref linkend="function.PDOStatement-columnCount" /> fonctionne avec ou sans jeu de résultats. </para> <programlisting role="php"> <![CDATA[ <?php $dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2'); $sth = $dbh->prepare("SELECT nom, couleur FROM fruit"); /* Compte le nombre de colonnes dans le jeu de résultat (non-existant) */ $colcount = $sth->columnCount(); print("Avant execute(), le jeu de résultats avait $colcount colonnes (devrait être 0)\n"); $sth->execute(); /* Compte le nombre de colonnes dans le jeu de résultats */ $colcount = $sth->columnCount(); print("Après execute(), le jeu de résultats a $colcount colonnes (devrait être 2)\n"); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Avant execute(), le jeu de résultats avait 0 colonnes (devrait être 0) Après execute(), le jeu de résultat a 2 colonnes (devrait être 2) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> <member><xref linkend="function.PDOStatement-rowCount" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/errorcode.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/errorcode.xml +++ phpdoc-fr/reference/pdo/pdostatement/errorcode.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-errorCode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->errorCode()</refname> <refpurpose> Récupère le SQLSTATE associé lors de la dernière opération sur la requête </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>string</type><methodname>errorCode</methodname> <void/> </methodsynopsis> </classsynopsis> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Identique à <xref linkend="function.PDO-errorCode" />, excepté que <xref linkend="function.PDOStatement-errorCode" /> récupère uniquement les codes erreurs pour les opérations sur les objets PDOStatement. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Détermine la catégorie de l'erreur qui survient</title> <programlisting role="php"> <![CDATA[ <?php /* Provoque une erreur -- la table BONES n'existe pas */ $err = $dbh->prepare('SELECT skull FROM bones'); $err->execute(); echo "\nPDOStatement::errorCode(): "; print $err->errorCode(); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ PDOStatement::errorCode(): 42S02 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-errorCode" /></member> <member><xref linkend="function.PDO-errorInfo" /></member> <member><xref linkend="function.PDOStatement-errorInfo" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/errorinfo.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/errorinfo.xml +++ phpdoc-fr/reference/pdo/pdostatement/errorinfo.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-errorInfo" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->errorInfo()</refname> <refpurpose> Récupère les informations sur l'erreur associée lors dernière opération sur la requête </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>array</type><methodname>errorInfo</methodname> <void/> </methodsynopsis> </classsynopsis> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDOStatement-errorInfo" /> retourne un tableau contenant des informations sur l'erreur survenu lors de la dernière opération exécutée par ce gestionnaire de requêtes. Le tableau contient les champs suivants : <informaltable> <tgroup cols='2'> <thead> <row> <entry>Élément</entry> <entry>Information</entry> </row> </thead> <tbody> <row> <entry>0</entry> <entry>Code erreur SQLSTATE (un identifiant de cinq caractères alphanumériques défini dans le standard ANSI SQL)</entry> </row> <row> <entry>1</entry> <entry>Code erreur spécifique au driver.</entry> </row> <row> <entry>2</entry> <entry>Message d'erreur spécifique au driver.</entry> </row> </tbody> </tgroup> </informaltable> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Affiche les champs de errorInfo() pour une connexion PDO_ODBC sur une base de donnés DB2</title> <programlisting role="php"> <![CDATA[ <?php /* Provoque une erreur -- la table BONES n'existe pas */ $sth = $dbh->prepare('SELECT skull FROM bones'); $sth->execute(); echo "\nPDOStatement::errorInfo():\n"; $arr = $sth->errorInfo(); print_r($arr); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ PDOStatement::errorInfo(): Array ( [0] => 42S02 [1] => -204 [2] => [IBM][CLI Driver][DB2/LINUX] SQL0204N "DANIELS.BONES" is an undefined name. SQLSTATE=42704 ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-errorCode" /></member> <member><xref linkend="function.PDO-errorInfo" /></member> <member><xref linkend="function.PDOStatement-errorCode" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/execute.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/execute.xml +++ phpdoc-fr/reference/pdo/pdostatement/execute.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-execute" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->execute()</refname> <refpurpose> Exécute une requête préparée </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>execute</methodname> <methodparam choice="opt"><type>array</type><parameter>input_parameters</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Exécute une requête préparée. Si la requête préparée inclut des marqueurs de positionnement, vous pouvez : <itemizedlist> <listitem><para>appeler la fonction <xref linkend="function.PDOStatement-bindParam" /> pour lier les variables PHP aux marqueurs de positionnement : les variables liées passent leurs valeurs en entrée et reçoivent les valeurs de sortie, s'il y en a, de leurs marqueurs de positionnement respectifs</para></listitem> <listitem><para>ou passer un tableau de valeurs de paramètres, uniquement en entrée</para></listitem> </itemizedlist> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>input_parameters</parameter></term> <listitem> <para> Un tableau de valeurs avec autant d'éléments qu'il y a de paramètres à associer dans la requête SQL qui sera exécutées. </para> <para> Vous ne pouvez associer plusieurs valeurs à un seul paramètre; par exemple, vous ne pouvez associer deux valeurs à un paramètre de nom dans une clause IN(). </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <example> <title>Exécute une requête préparée avec des variables liées</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en liant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); $sth->bindParam(':calories', $calories, PDO::PARAM_INT); $sth->bindParam(':couleur', $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> </programlisting> </example> <example> <title>Exécute une requête préparée avec un tableau de valeurs (paramètres de nom)</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en passant un tableau de valeurs */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); $sth->execute(array(':calories' => $calories, ':couleur' => $couleur)); ?> ]]> </programlisting> </example> <example> <title>Exécute une requête préparée avec un tableau de valeurs (marqueurs)</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en passant un tableau de valeurs */ $calories = 150; $colour = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); $sth->execute(array($calories, $couleur)); ?> ]]> </programlisting> </example> <example> <title>Exécute une requête préparée avec un marqueur de positionnement</title> <programlisting role='php'> <![CDATA[ <?php /* Exécute une requête préparée en liant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); $sth->bindParam(1, $calories, PDO::PARAM_INT); $sth->bindParam(2, $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?> ]]> </programlisting> </example> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-bindParam" /></member> <member><xref linkend="function.PDOStatement-fetch" /></member> <member><xref linkend="function.PDOStatement-fetchAll" /></member> <member><xref linkend="function.PDOStatement-fetchColumn" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/fetch.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/fetch.xml +++ phpdoc-fr/reference/pdo/pdostatement/fetch.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-fetch" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->fetch()</refname> <refpurpose> Récupère la ligne suivante d'un jeu de résultat PDO </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>mixed</type><methodname>fetch</methodname> <methodparam choice="opt"><type>int</type><parameter>fetch_style</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>cursor_orientation</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>cursor_offset</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Récupère une ligne depuis un jeu de résultats associé à l'objet <literal>PDOStatement</literal>. Le paramètre <parameter>fetch_style</parameter> détermine la façon dont PDO retourne la ligne. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>fetch_style</parameter></term> <listitem> <para> Contrôle comment la prochaine ligne sera retournée à l'appelant. Cette valeur doit être une des constantes <literal>PDO::FETCH_*</literal>, et par défaut, vaut <literal>PDO::FETCH_BOTH</literal>. <itemizedlist> <listitem><para> <literal>PDO::FETCH_ASSOC</literal>: retourne un tableau indexé par le nom de la colonne comme retourné dans le jeu de résultats </para></listitem> <listitem><para> <literal>PDO_FETCH_BOTH</literal> (défaut): retourne un tableau indexé par les noms de colonnes mais aussi par les numéros de colonnes (commençant à l'indice 0), comme retournés dans le jeu de résultats </para></listitem> <listitem><para> <literal>PDO::FETCH_BOUND</literal>: retourne &true; et assigne les valeurs des colonnes de votre jeu de résultats dans les variables PHP à laquelle elles sont liées avec la méthode <xref linkend="function.PDOStatement-bindParam" /> </para></listitem> <listitem><para> <literal>PDO::FETCH_CLASS</literal>: retourne une nouvelle instance de la classe demandée, liant les colonnes du jeu de résultats aux noms des propriétés de la classe. Si <parameter>fetch_style</parameter> inclut PDO::FETCH_CLASS (c'est-à-dire <literal>PDO::FETCH_CLASS | PDO::FETCH_CLASSTYPE</literal>), alors le nom de la classe est déterminé à partir d'une valeur de la première colonne. </para></listitem> <listitem><para> <literal>PDO::FETCH_INTO</literal>: met à jour une instance existante de la classe demandée, liant les colonnes du jeu de résultats aux noms des propriétés de la classe </para></listitem> <listitem><para> <literal>PDO::FETCH_LAZY</literal>: combine <literal>PDO::FETCH_BOTH</literal> et <literal>PDO::FETCH_OBJ</literal>, créant ainsi les noms des variables de l'objet, comme elles sont accédées </para></listitem> <listitem><para> <literal>PDO::FETCH_NUM</literal>: retourne un tableau indexé par le numéro de la colonne comme elle est retourné dans votre jeu de résultat, commençant à 0 </para></listitem> <listitem><para> <literal>PDO_FETCH_OBJ</literal>: retourne un objet anonyme avec les noms de propriétés qui correspondent aux noms des colonnes retournés dans le jeu de résultats </para></listitem> </itemizedlist> </para> </listitem> </varlistentry> <varlistentry> <term><parameter>cursor_orientation</parameter></term> <listitem> <para> Pour un objet PDOStatement représentant un curseur scrollable, cette valeur détermine quelle ligne sera retournée à l'appelant. Cette valeur doit être une des constantes <literal>PDO::FETCH_ORI_*</literal>, et par défaut, vaut <literal>PDO::FETCH_ORI_NEXT</literal>. Pour demander un curseur scrollable pour votre objet PDOStatement, vous devez définir l'attribut <literal>PDO::ATTR_CURSOR</literal> à <literal>PDO::CURSOR_SCROLL</literal> lorsque vous préparez la requête SQL avec la fonction <xref linkend="function.PDO-prepare" />. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>offset</parameter></term> <listitem> <para> Pour un objet PDOStatement représentant un curseur scrollable pour lequel le paramètre <literal>cursor_orientation</literal> est défini à <literal>PDO::FETCH_ORI_ABS</literal>, cette valeur spécifie le numéro absolu de la ligne dans le jeu de résultats qui doit être récupérée. </para> <para> Pour un objet PDOStatement représentant un curseur scrollable pour lequel le paramètre <literal>cursor_orientation</literal> est défini à <literal>PDO::FETCH_ORI_REL</literal>, cette valeur spécifie la ligne à récupérer relativement à la position du curseur avant l'appel à la fonction <xref linkend="function.PDOStatement-fetch" />. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Récupération de lignes en utilisant différentes méthodes</title> <programlisting role="php"> <![CDATA[ <?php $sth = $dbh->prepare("SELECT nom, couleur FROM fruit"); $sth->execute(); /* styles PDOStatement::fetch */ print("PDO::FETCH_ASSOC: "); print("Retourne la ligne suivante en tant qu'un tableau indexé par le nom des colonnes\n"); $result = $sth->fetch(PDO::FETCH_ASSOC); print_r($result); print("\n"); print("PDO::FETCH_BOTH: "); print("Retourne la ligne suivante en tant qu'un tableau indexé par le nom et le numéro de la colonne\n"); $result = $sth->fetch(PDO::FETCH_BOTH); print_r($result); print("\n"); print("PDO::FETCH_LAZY: "); print("Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés\n"); $result = $sth->fetch(PDO::FETCH_LAZY); print_r($result); print("\n"); print("PDO::FETCH_OBJ: "); print("Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés\n"); $result = $sth->fetch(PDO::FETCH_OBJ); print $result->NAME; print("\n"); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ PDO::FETCH_ASSOC: Retourne la ligne suivante en tant qu'un tableau indexé par le nom des colonnes Array ( [NOM] => apple [COULEUR] => red ) PDO::FETCH_BOTH: Retourne la ligne suivante en tant qu'un tableau indexé par le nom et le numéro de la colonne Array ( [NOM] => banana [0] => banana [COULEUR] => yellow [1] => yellow ) PDO::FETCH_LAZY: Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés PDORow Object ( [NOM] => orange [COULEUR] => orange ) PDO::FETCH_OBJ: Retourne la ligne suivante en tant qu'objet anonyme ayant les noms de colonnes comme propriétés kiwi ]]> </screen> </example> <example> <title>Récupération des lignes avec un curseur scrollable</title> <programlisting role="php"> <![CDATA[ <?php function readDataForwards($dbh) { $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY BET'; try { $stmt = $dbh->prepare($sql, array(PDO::ATTR_CURSOR, PDO::CURSOR_SCROLL)); $stmt->execute(); while ($row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_NEXT)) { $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n"; print $data; } $stmt = null; } catch (PDOException $e) { print $e->getMessage(); } } function readDataBackwards($dbh) { $sql = 'SELECT hand, won, bet FROM mynumbers ORDER BY bet'; try { $stmt = $dbh->prepare($sql, array(PDO::ATTR_CURSOR, PDO::CURSOR_SCROLL)); $stmt->execute(); $row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_LAST); do { $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n"; print $data; } while ($row = $stmt->fetch(PDO::FETCH_NUM, PDO::FETCH_ORI_PRIOR)); $stmt = null; } catch (PDOException $e) { print $e->getMessage(); } } print "Lecture en avant :\n"; readDataForwards($conn); print "Lecture en arrière :\n"; readDataBackwards($conn); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Lecture en avant : 21 10 5 16 0 5 19 20 10 Lecture en arrière : 19 20 10 16 0 5 21 10 5 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-query" /></member> <member><xref linkend="function.PDOStatement-fetchAll" /></member> <member><xref linkend="function.PDOStatement-fetchColumn" /></member> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-setFetchMode" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/fetchall.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/fetchall.xml +++ phpdoc-fr/reference/pdo/pdostatement/fetchall.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-fetchAll" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->fetchAll()</refname> <refpurpose> Retourne un tableau contenant toutes les lignes du jeu d'enregistrements </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>array</type><methodname>fetchAll</methodname> <methodparam choice="opt"><type>int</type><parameter>fetch_style</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>column_index</parameter></methodparam> </methodsynopsis> </classsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>fetch_style</parameter></term> <listitem> <para> Contrôle le contenu du tableau retourné comme documenté dans la fonction <xref linkend="function.PDOStatement-fetch" />. Vaut par défaut <literal>PDO::FETCH_BOTH</literal>. </para> <para> Pour retourner un tableau contenant toutes les valeurs d'une seule colonne depuis le jeu de résultats, spécifiez <literal>PDO::FETCH_COLUMN</literal>. Vous pouvez spécifier quelle colonne vous voulez avec le paramètre <parameter>column-index</parameter>. </para> <para> Pour récupérer uniquement les valeurs uniques d'une seule colonne depuis le jeu de résultats, utilisez <literal>PDO::FETCH_COLUMN</literal> avec <literal>PDO::FETCH_UNIQUE</literal>. </para> <para> Pour retourner un tableau associatif groupé par les valeurs d'une colonne spécifique, utilisez <literal>PDO::FETCH_COLUMN</literal> avec <literal>PDO::FETCH_GROUP</literal>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>column_index</parameter></term> <listitem> <para> Retourne la colonne indiquée où la valeur de <parameter>fetch_style</parameter> est <literal>PDO::FETCH_COLUMN</literal>. Vaut par défaut &zero;. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDOStatement-fetchAll" /> retourne un tableau contenant toutes les lignes du jeu d'enregistrements. Le tableau représente chaque ligne comme soit un tableau de valeurs des colonnes, soit un objet avec des propriétés correspondant à chaque nom de colonne. </para> <para> L'utilisation de cette méthode pour récupérer de gros jeux de résultats peut augmenter les ressources du systèmes mais également ces ressources. Plutôt que de récupérer toutes les données et de les manipuler avec PHP, utilisez le serveur de base de données pour manipuler les jeux de résultats. Par exemple, utilisez les clauses <literal>WHERE</literal> et <literal>ORDER BY</literal> dans vos requêtes SQL pour restreindre les résultats avant de le récupérer et de les traiter avec PHP. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Récupération de toutes les lignes d'un jeu de résultats</title> <programlisting role="php"> <![CDATA[ <?php $sth = $dbh->prepare("SELECT nom, couleur FROM fruit"); $sth->execute(); /* Récupération de toutes les lignes d'un jeu de résultats */ print("Récupération de toutes les lignes d'un jeu de résultats :\n"); $result = $sth->fetchAll(); print_r($result); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Récupération de toutes les lignes d'un jeu de résultats : Array ( [0] => Array ( [NOM] => pear [0] => pear [COULEUR] => green [1] => green ) [1] => Array ( [NOM] => watermelon [0] => watermelon [COULEUR] => pink [1] => pink ) ) ]]> </screen> </example> <example> <title>Récupération de toutes les valeurs d'une seule colonne depuis un jeu de résultats</title> <para> L'exemple suivant montre comment retourner toutes les valeurs d'une seule colonne depuis un jeu de résultats, même si la requête SQL retourne plusieurs colonnes par lignes. </para> <programlisting role="php"> <![CDATA[ <?php $sth = $dbh->prepare("SELECT name, colour FROM fruit"); $sth->execute(); /* Récupération de toutes les valeurs de la première colonne */ $result = $sth->fetchAll(PDO::FETCH_COLUMN, 0); var_dump($result); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Array(3) ( [0] => string(5) => apple [1] => string(4) => pear [2] => string(10) => watermelon ) ]]> </screen> </example> <example> <title>Grouper toutes les valeurs d'une seule colonne</title> <para> L'exemple suivant montre comment retourner un tableau associatif groupé par les valeurs de la colonne spécifiée d'un jeu de résultats. Le tableau contient trois clés : les valeurs <literal>apple</literal> et <literal>pear</literal> sont retournées sous la forme de tableaux qui contiennent deux couleurs différentes, tandis que <literal>watermelon</literal> est retourné sous la forme d'un tableau qui contient uniquement une seule couleur. </para> <programlisting role="php"> <![CDATA[ <?php $insert = $dbh->prepare("INSERT INTO fruit(name, colour) VALUES (?, ?)"); $insert->execute('apple', 'green'); $insert->execute('pear', 'yellow'); $sth = $dbh->prepare("SELECT name, colour FROM fruit"); $sth->execute(); /* Grouper les valeurs de la première colonne */ var_dump($sth->fetchAll(PDO::FETCH_COLUMN|PDO::FETCH_GROUP)); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array(3) { ["apple"]=> array(2) { [0]=> string(5) "green" [1]=> string(3) "red" } ["pear"]=> array(2) { [0]=> string(5) "green" [1]=> string(6) "yellow" } ["watermelon"]=> array(1) { [0]=> string(5) "green" } } ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-query" /></member> <member><xref linkend="function.PDOStatement-fetch" /></member> <member><xref linkend="function.PDOStatement-fetchColumn" /></member> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-setFetchMode" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/fetchcolumn.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/fetchcolumn.xml +++ phpdoc-fr/reference/pdo/pdostatement/fetchcolumn.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-fetchColumn" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->fetchColumn()</refname> <refpurpose> Retourne une colonne depuis la ligne suivante d'un jeu de résultats </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>string</type><methodname>fetchColumn</methodname> <methodparam choice="opt"><type>int</type><parameter>column_number</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Retourne une colonne depuis la ligne suivante d'un jeu de résultats ou &false; s'il n'y a plus de ligne. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>column_number</parameter></term> <listitem> <para> Numéro de la colonne que vous voulez récupérer depuis la ligne (commençant à 0). Si aucune valeur n'est fournie, <xref linkend="function.PDOStatement-fetchColumn" /> récupérera la première colonne. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <xref linkend="function.PDOStatement-fetchColumn" /> retourne une colonne depuis la ligne suivante d'un jeu de résultats. </para> <warning> <para> Il n'y a pas de solution pour retourner une autre colonne depuis la même ligne si vous utilisez la fonction <xref linkend="function.PDOStatement-fetchColumn" /> pour récupérer les données. </para> </warning> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Retourne la première colonne de la ligne suivante</title> <programlisting role="php"> <![CDATA[ <?php $sth = $dbh->prepare("SELECT nom, couleur FROM fruit"); $sth->execute(); /* Récupère la première colonne depuis la ligne suivante d'un jeu de résultats */ print("Récupère la première colonne depuis la ligne suivante d'un jeu de résultats :\n"); $result = $sth->fetchColumn(); print("nom=$result\n"); print("Récupère la deuxième colonne depuis la ligne suivante d'un jeu de résultats :\n"); $result = $sth->fetchColumn(); print("couleur=$result\n"); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Récupère la première colonne depuis la ligne suivante d'un jeu de résultats : nom=lemon Récupère la deuxième colonne depuis la ligne suivante d'un jeu de résultats : couleur=orange ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-query" /></member> <member><xref linkend="function.PDOStatement-fetch" /></member> <member><xref linkend="function.PDOStatement-fetchAll" /></member> <member><xref linkend="function.PDO-prepare" /></member> <member><xref linkend="function.PDOStatement-setFetchMode" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/fetchobject.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/fetchobject.xml +++ phpdoc-fr/reference/pdo/pdostatement/fetchobject.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-fetchObject" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->fetchObject()</refname> <refpurpose>Récupère la prochaine ligne et la retourne en tant qu'objet</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>mixed</type><methodname>fetchObject</methodname> <methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>ctor_args</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Récupère la prochaine ligne et la retourne en tant qu'objet. Cette fonction est une alternative à <xref linkend="function.PDOStatement-fetch" /> avec <constant>PDO::FETCH_CLASS</constant> ou le style <constant>PDO::FETCH_OBJ</constant>. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>class_name</parameter></term> <listitem> <para> Nom de la classe créée, la valeur par défaut est <literal>stdClass</literal>. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>ctor_args</parameter></term> <listitem> <para> Éléments de ce tableau sont passés au constructeur. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne une instance de la classe demandée avec les propriétés de noms qui correspondent aux noms des colonnes ou &false; en cas d'une erreur. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDOStatement-fetch" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/getattribute.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/getattribute.xml +++ phpdoc-fr/reference/pdo/pdostatement/getattribute.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-getAttribute" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->getAttribute()</refname> <refpurpose> Récupère un attribut de requête </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>mixed</type><methodname>getAttribute</methodname> <methodparam><type>int</type><parameter>attribute</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Récupère un attribut de la requête. Actuellement, aucun attribut générique n'existe, mais uniquement des spécificités du driver : <itemizedlist> <listitem><para><literal>PDO::ATTR_CURSOR_NAME</literal> (spécificité de Firebird et d'ODBC) : Récupère le nom du curseur pour <literal>UPDATE ... WHERE CURRENT OF</literal>. </para></listitem> </itemizedlist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la valeur de l'attribut. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-getAttribute" /></member> <member><xref linkend="function.PDO-setAttribute" /></member> <member><xref linkend="function.PDOStatement-setAttribute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/getcolumnmeta.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/getcolumnmeta.xml +++ phpdoc-fr/reference/pdo/pdostatement/getcolumnmeta.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-getColumnMeta" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->getColumnMeta()</refname> <refpurpose> Retourne les métadonnées pour une colonne d'un jeu de résultats </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>mixed</type><methodname>getColumnMeta</methodname> <methodparam><type>int</type><parameter>column</parameter></methodparam> </methodsynopsis> </classsynopsis> &warn.undocumented.func; <para> Récupère les metainformations pour une colonne d'un jeu de résultat dans un tableau associatif. </para> <warning> <simpara> Tous les drivers PDO ne supportent pas la fonction <xref linkend="function.PDOStatement-getColumnMeta" />. </simpara> </warning> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>column</parameter></term> <listitem> <para> Le nom de la colonne dans le jeu de résultat. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne un tableau associatif contenant les valeurs suivantes représentant les metainformations pour une colonne : </para> <table> <title>Metainformations d'une colonne</title> <tgroup cols='2'> <colspec colname='c1'/> <colspec colname='c2'/> <thead> <row> <entry>Nom</entry> <entry>Valeur</entry> </row> </thead> <tbody> <row> <entry><literal>native_type</literal></entry> <entry>Le type natif PHP utilisé pour représenter la valeur de la colonne.</entry> </row> <row> <entry><literal>driver:decl_type</literal></entry> <entry>Le type SQL utilisé pour représenter la valeur de la colonne dans la base de données. Si la colonne du jeu de résultat est le résultat d'une fonction, cette valeur n'est pas retournée par la fonction <xref linkend="function.PDOStatement-getColumnMeta" />. </entry> </row> <row> <entry><literal>flags</literal></entry> <entry>N'importe quelle balise définie pour cette colonne.</entry> </row> <row> <entry><literal>name</literal></entry> <entry>Le nom de cette colonne, comme retourné par la base de données.</entry> </row> <row> <entry><literal>len</literal></entry> <entry>La longueur de cette colonne. Normalement, <literal>-1</literal> pour les types autres que les nombres décimaux à virgule flottante.</entry> </row> <row> <entry><literal>precision</literal></entry> <entry>La précision numérique pour cette colonne. Normalement, &zero; pour les types autres que les nombres décimaux à virgule flottante.</entry> </row> <row> <entry><literal>pdo_type</literal></entry> <entry>Le type de cette colonne comme représenté par la constante <literal>PDO::PARAM_*</literal> constants.</entry> </row> </tbody> </tgroup> </table> <para> Retourne &false; si la colonne demandée n'existe pas dans le jeu de résultats, ou si aucun jeu de résultats n'existe. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Récupération des metainformations pour une colonne</title> <para> L'exemple suivant montre le résultat de la récupération des metainformations pour une colonne générée par une fonction (COUNT) dans un pilote PDO_SQLITE. </para> <programlisting role="php"> <![CDATA[ <?php $select = $DB->query('SELECT COUNT(*) FROM fruit'); $meta = $select->getColumnMeta(0); var_dump($meta); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ array(6) { ["native_type"]=> string(7) "integer" ["flags"]=> array(0) { } ["name"]=> string(8) "COUNT(*)" ["len"]=> int(-1) ["precision"]=> int(0) ["pdo_type"]=> int(2) } ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDOStatement-columnCount" /></member> <member><xref linkend="function.PDOStatement-rowCount" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/nextrowset.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/nextrowset.xml +++ phpdoc-fr/reference/pdo/pdostatement/nextrowset.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-nextRowset" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->nextRowset()</refname> <refpurpose> Avance à la prochaine ligne de résultats d'un gestionnaire de lignes de résultats multiples </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>nextRowset</methodname> <void/> </methodsynopsis> </classsynopsis> <para> Quelques bases de données supportent les procédures stockées qui retournent plus d'une ligne de résultats (aussi connu comme des jeux de résultats). <xref linkend="function.PDOStatement-nextRowset" /> vous permet d'accéder à la seconde et suivantes lignes de résultats associées avec l'objet PDOStatement. Chaque ligne de résultats a des jeux différents de colonnes depuis la ligne de résultats. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Récupération de multiples lignes de résultats retournées par une procédure stockée</title> <para> L'exemple suivant montre comment appeler une procédure stockée, MULTIPLE_RESULTS, qui retourne trois lignes de résultats. Nous utilisons une boucle do / while pour parcourir la méthode <xref linkend="function.PDOStatement-nextRowset" />, qui retourne &false; et termine la boucle lorsque plus aucune ligne de résultats ne peut être retournée. </para> <programlisting role="php"> <![CDATA[ <?php $sql = 'CALL multiple_rowsets()'; $stmt = $conn->query($sql); $i = 1; do { $rowset = $stmt->fetchAll(PDO::FETCH_NUM); if ($rowset) { printResultSet($rowset, $i); } $i++; } while ($stmt->nextRowset()); function printResultSet(&$rowset, $i) { print "Jeu de résultats $i:\n"; foreach ($rowset as $row) { foreach ($row as $col) { print $col . "\t"; } print "\n"; } print "\n"; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Jeu de résultats 1: apple red banana yellow Jeu de résultats 2: orange orange 150 banana yellow 175 Jeu de résultats 3: lime green apple red banana yellow ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDOStatement-columnCount" /></member> <member><xref linkend="function.PDOStatement-execute" /></member> <member><xref linkend="function.PDOStatement-getColumnMeta" /></member> <member><xref linkend="function.PDO-query" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/rowcount.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/rowcount.xml +++ phpdoc-fr/reference/pdo/pdostatement/rowcount.xml <?xml version='1.0' encoding='iso-8859-1'?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-rowCount" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->rowCount()</refname> <refpurpose> Retourne le nombre de lignes affectées par le dernier appel à la fonction PDOStatement::execute() </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>int</type><methodname>rowCount</methodname> <void/> </methodsynopsis> </classsynopsis> <para> <xref linkend="function.PDOStatement-rowCount" /> retourne le nombre de lignes affectées par la dernière requête DELETE, INSERT ou UPDATE exécutée par l'objet <literal>PDOStatement</literal> correspondant. </para> <para> Si la dernière requête SQL exécutée par l'objet <literal>PDOStatement</literal> associé est une requête de type SELECT, quelques bases de données retourneront le nombre de lignes retournées par cette requête. Néanmoins, ce comportement n'est pas garanti pour toutes les bases de données et ne devrait pas être exécuté pour des applications portables. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Retourne le nombre de lignes effacées</title> <para> <xref linkend="function.PDOStatement-rowCount" /> retourne le nombre de lignes affectées par une requête DELETE, INSERT, ou UPDATE. </para> <programlisting role="php"> <![CDATA[ <?php /* Effacement de toutes les lignes de la table FRUIT */ $del = $dbh->prepare('DELETE FROM fruit'); $del->execute(); /* Retourne le nombre de lignes effacées */ print("Retourne le nombre de lignes effacées :\n"); $count = $del->rowCount(); print("Effacement de $count lignes.\n"); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Effacement de 9 lignes. ]]> </screen> </example> <example> <title>Comptage des lignes retournées par une requête SELECT</title> <para> Pour la plupart des bases de données, <xref linkend="function.PDOStatement-rowCount" /> ne retourne pas le nombre de lignes affectées par une requête SELECT. À la place, utilisez <xref linkend="function.PDO-query" /> pour faire une requête SELECT COUNT(*), puis utilisez <xref linkend="function.PDOStatement-fetchColumn" /> pour récupérer le nombre de lignes retournées. Votre application peut ainsi effectuer la bonne action. </para> <programlisting role="php"> <![CDATA[ <?php $sql = "SELECT COUNT(*) FROM fruit WHERE calories > 100"; if ($res = $conn->query($sql)) { /* Récupère le nombre de lignes qui correspond à la requête SELECT */ if ($res->fetchColumn() > 0) { /* Effectue la vraie requête SELECT et travaille sur le résultat */ $sql = "SELECT nom FROM fruit WHERE calories > 100"; foreach ($conn->query($sql) as $row) { print "Nom : " . $row['NOM'] . "\n"; } } /* Aucune ligne ne correspond -- faire quelque chose d'autre */ else { print "Aucune ligne ne correspond à la requête."; } } $res = null; $conn = null; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ apple banana orange pear ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDOStatement-columnCount" /></member> <member><xref linkend="function.PDOStatement-fetchColumn" /></member> <member><xref linkend="function.PDO-query" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/setattribute.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/setattribute.xml +++ phpdoc-fr/reference/pdo/pdostatement/setattribute.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-setAttribute" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->setAttribute()</refname> <refpurpose> Définie un attribut de requête </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>setAttribute</methodname> <methodparam><type>int</type><parameter>attribute</parameter></methodparam> <methodparam><type>mixed</type><parameter>value</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Définit un attribut de la requête. Actuellement, aucun attribut générique n'est défini, mais uniquement des spécificités du driver : <itemizedlist> <listitem><para><literal>PDO::ATTR_CURSOR_NAME</literal> (spécificité de Firebird et d'ODBC) : Définit le nom du curseur pour <literal>UPDATE ... WHERE CURRENT OF</literal>. </para></listitem> </itemizedlist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><xref linkend="function.PDO-getAttribute" /></member> <member><xref linkend="function.PDO-setAttribute" /></member> <member><xref linkend="function.PDOStatement-getAttribute" /></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement/setfetchmode.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/pdo/pdostatement/setfetchmode.xml +++ phpdoc-fr/reference/pdo/pdostatement/setfetchmode.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry xml:id="function.PDOStatement-setFetchMode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>PDOStatement->setFetchMode()</refname> <refpurpose> Définit le mode de récupération par défaut pour cette requête </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>setFetchMode</methodname> <methodparam><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> </classsynopsis> <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>setFetchMode</methodname> <methodparam><type>int</type><parameter>PDO::FETCH_COLUMN</parameter></methodparam> <methodparam><type>int</type><parameter>colno</parameter></methodparam> </methodsynopsis> </classsynopsis> <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>setFetchMode</methodname> <methodparam><type>int</type><parameter>PDO::FETCH_CLASS</parameter></methodparam> <methodparam><type>string</type><parameter>classname</parameter></methodparam> <methodparam><type>array</type><parameter>ctorargs</parameter></methodparam> </methodsynopsis> </classsynopsis> <classsynopsis> <ooclass><classname>PDOStatement</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>setFetchMode</methodname> <methodparam><type>int</type><parameter>PDO::FETCH_INTO</parameter></methodparam> <methodparam><type>object</type><parameter>object</parameter></methodparam> </methodsynopsis> </classsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>mode</parameter></term> <listitem> <para> Le mode de récupération doit être une des constantes <literal>PDO::FETCH_*</literal>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne &one; en cas de succès ou &false; si une erreur survient. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>Définition du mode de récupération</title> <para> L'exemple suivant montre comment <xref linkend="function.PDOStatement-setFetchMode" /> modifie le mode de récupération par défaut pour un objet PDOStatement. </para> <programlisting role="php"> <![CDATA[ <?php $sql = 'SELECT name, colour, calories FROM fruit'; try { $stmt = $dbh->query($sql); $result = $stmt->setFetchMode(PDO::FETCH_NUM); while ($row = $stmt->fetch()) { print $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n"; } } catch (PDOException $e) { print $e->getMessage(); } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ apple red 150 banana yellow 250 orange orange 300 kiwi brown 75 lemon yellow 25 pear green 150 watermelon pink 90 ]]> </screen> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->