cvs: phpdoc-fr /reference/mysqli/functions mysqli-affected-rows.xml mysqli-embedded-connect.xml mysqli-escape-string.xml mysqli-get-client-version.xml
mysqli-get-metadata.xml mysqli-more-results.xml mysqli-multi-query.xml mysqli-next-result.xml mysqli-report.xml mysqli-server-end.xml
mysqli-server-init.xml mysqli-set-opt.xml mysqli-sqlstate.xml mysqli-stmt-bind-param.xml mysqli-stmt-bind-result.xml mysqli-stmt-data-seek.xml
mysqli-stmt-execute.xml mysqli-stmt-fetch.xml mysqli-stmt-free-result.xml mysqli-stmt-init.xml mysqli-stmt-num-rows.xml mysqli-stmt-param-count.xml
mysqli-stmt-prepare.xml mysqli-stmt-result-metadata.xml mysqli-stmt-send-long-data.xml mysqli-stmt-sqlstate.xml
| From: | Damien Seguy | Date: | Wed, 31 Mar 2004 16:09:36 +0000 |
| Subject: | cvs: phpdoc-fr /reference/mysqli/functions mysqli-affected-rows.xml mysqli-embedded-connect.xml mysqli-escape-string.xml mysqli-get-client-version.xml mysqli-get-metadata.xml mysqli-more-results.xml mysqli-multi-query.xml mysqli-next-result.xml mysqli-report.xml mysqli-server-end.xml mysqli-server-init.xml mysqli-set-opt.xml mysqli-sqlstate.xml mysqli-stmt-bind-param.xml mysqli-stmt-bind-result.xml mysqli-stmt-data-seek.xml mysqli-stmt-execute.xml mysqli-stmt-fetch.xml mysqli-stmt-free-result.xml mysqli-stmt-init.xml mysqli-stmt-num-rows.xml mysqli-stmt-param-count.xml mysqli-stmt-prepare.xml mysqli-stmt-result-metadata.xml mysqli-stmt-send-long-data.xml mysqli-stmt-sqlstate.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-2112@lists.php.net to get a copy of this message | ||
dams Wed Mar 31 11:09:36 2004 EDT
Added files:
/phpdoc-fr/reference/mysqli/functions mysqli-embedded-connect.xml
mysqli-escape-string.xml
mysqli-get-client-version.xml
mysqli-get-metadata.xml
mysqli-more-results.xml
mysqli-multi-query.xml
mysqli-next-result.xml
mysqli-report.xml
mysqli-server-end.xml
mysqli-server-init.xml
mysqli-set-opt.xml
mysqli-sqlstate.xml
mysqli-stmt-bind-param.xml
mysqli-stmt-bind-result.xml
mysqli-stmt-data-seek.xml
mysqli-stmt-execute.xml
mysqli-stmt-fetch.xml
mysqli-stmt-free-result.xml
mysqli-stmt-init.xml
mysqli-stmt-num-rows.xml
mysqli-stmt-param-count.xml
mysqli-stmt-prepare.xml
mysqli-stmt-result-metadata.xml
mysqli-stmt-send-long-data.xml
mysqli-stmt-sqlstate.xml
Modified files:
/phpdoc-fr/reference/mysqli/functions mysqli-affected-rows.xml
Log:
initial translation
http://cvs.php.net/diff.php/phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml:1.7 phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml:1.8 --- phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml:1.7 Tue Feb 24 13:12:15 2004 +++ phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml Wed Mar 31 11:09:35 2004 @@ -1,38 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> <refentry id="function.mysqli-affected-rows"> <refnamediv> <refname>mysqli_affected_rows</refname> <refpurpose> - Retourne le nombre de ligne affectées par la dernière - opération MySQL + Retourne le nombre de ligne affectÈes par la derniËre + opÈration MySQL </refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>mysqli_affected_rows</methodname> - <methodparam><type>resource</type><parameter>link</parameter></methodparam> - </methodsynopsis> + <para>ProcÈdural</para> + <methodsynopsis> + <type>mixed</type><methodname>mysqli_affected_rows</methodname> + <methodparam><type>object</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>OrientÈ objet</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <fieldsynopsis><type>mixed</type><varname>affected_rows</varname></fieldsynopsis> + </classsynopsis> <para> <function>mysqli_affected_rows</function> retourne le nombre de lignes - affectées par la dernière requête INSERT, UPDATE, ou - DELETE associée au paramètre <parameter>link</parameter>. - Si la dernière requête était invalide, cette fonction + affectÈes par la derniËre requête INSERT, UPDATE, ou + DELETE associÈe au paramËtre <parameter>link</parameter>. + Si la derniËre requête Ètait invalide, cette fonction retournera -1. </para> <note> <para> Lorsque vous supprimez tout le contenu de la table (i.e. 'DELETE FROM - foo'), cette fonction ne retourne pas le nombre de lignes effacées. + foo'), cette fonction ne retourne pas le nombre de lignes effacÈes. </para> </note> <para> La fonction <function>mysqli_affected_rows</function> ne fonctionne que pour les requêtes qui modifient une table. Pour connaître le - nombre de lignes retournées par une requête SELECT, utilisez + nombre de lignes retournÈes par une requête SELECT, utilisez la fonction <function>mysqli_num_rows</function>. </para> <para> @@ -46,22 +52,22 @@ die("Impossible de se connecter : " . mysqli_error()); mysqli_select_db("mydb"); - /* cela devrait retourner le nombre correct de lignes effacées */ + /* cela devrait retourner le nombre correct de lignes effacÈes */ mysqli_query("DELETE FROM mytable WHERE id < 10"); - printf ("Enregistrements effacés : %d\n", mysqli_affected_rows()); + printf ("Enregistrements effacÈs : %d\n", mysqli_affected_rows()); /* sans la clause where dans la requête, cela devrait retourner 0 */ mysqli_query("DELETE FROM mytable"); - printf ("Enregistrements effacés : %d\n", mysqli_affected_rows()); + printf ("Enregistrements effacÈs : %d\n", mysqli_affected_rows()); ?> ]]> </programlisting> <para> - L'exemple précédent produira ce qui suit : + L'exemple prÈcÈdent produira ce qui suit : <screen> <![CDATA[ -Enregistrements effacés : 10 -Enregistrements effacés : 0 +Enregistrements effacÈs : 10 +Enregistrements effacÈs : 0 ]]> </screen> </para> @@ -83,7 +89,7 @@ ]]> </programlisting> <para> - L'exemple précédent produira ce qui suit : + L'exemple prÈcÈdent produira ce qui suit : <screen> <![CDATA[ Lignes mises à jour : 10 http://cvs.php.net/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-embedded-connect.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-embedded-connect.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-embedded-connect.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-embedded-connect"> <refnamediv> <refname>mysqli_embedded_connect</refname> <refpurpose>Ouvre une connexion avec un serveur MySQL intégré</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>object</type><methodname>mysqli_embedded_connect</methodname> <methodparam><type>void</type><parameter></parameter></methodparam> </methodsynopsis> &warn.experimental.func; </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-escape-string.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-escape-string.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-escape-string.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-escape-string"> <refnamediv> <refname>mysqli_escape_string</refname> <refpurpose>Alias de <function>mysqli_real_escape_string</function></refpurpose> </refnamediv> <refsect1> <title>Description</title> <para> <function>mysqli_escape_string</function> est un alias de <function>mysqli_real_escape_string</function>. </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-get-client-version.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-get-client-version.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-get-client-version.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-get-client-version"> <refnamediv> <refname>mysqli_get_client_version</refname> <refpurpose>Lit les informations du client MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>mysqli_get_client_version</methodname> <void/> </methodsynopsis> <para> <function>mysqli_get_client_version</function> retourne la version du client MySQL sous la forme d'un entier. </para> </refsect1> <refsect1> <title>Valeur retournée</title> <para> Un nombre qui représente la version de la bibliothèque cliente MySQL dans ce format : <literal>version_principale*10000 + version_mineure *100 + sous_version</literal>. Par exemple, la version 4.1.0 est retournée sous la forme 40100. </para> <para> Cette fonction est pratique pour déterminer la version de la bibliothèque cliente, si vous recherchez des fonctionnalités spécifiques. </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_get_client_info</function>, <function>mysqli_get_server_info</function> et <function>mysqli_get_server_version</function> </para> </refsect1> <refsect1> <title>Exemple</title> <para> <example> <title>Exemple avec <function>mysqli_get_client_version</function></title> <programlisting role='php'> <![CDATA[ <?php /* Nous n'avons pas besoin d'une connexion pour déterminer la version de la bibliothèque cliente mysql */ printf("Version de la bibliothèque : %d\n", mysqli_get_client_version()); ?> ]]> </programlisting> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-get-metadata.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-get-metadata.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-get-metadata.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-get-metadata"> <refnamediv> <refname>mysqli_get_metadata</refname> <refpurpose>Alias de <function>mysqli_stmt_result_metadata</function></refpurpose> </refnamediv> <refsect1> <title>Description</title> <para> <function>mysqli_get_metadata</function> est un alias de <function>mysqli_stmt_result_metadata</function>. Pour une description détaillée, reportez-vous à la documentation de <function>mysqli_stmt_result_metadata</function>. </para> <note> <para> <function>mysqli_get_metadata</function> est obsolète, et sera supprimé bientôt. </para> </note> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_stmt_result_metadata</function> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-more-results.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-more-results.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-more-results.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-more-results"> <refnamediv> <refname>mysqli_more_results</refname> <refname>mysqli->more_results</refname> <refpurpose>Vérifie s'il y a d'autres jeux de résultats MySQL disponibles</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>mysqli_more_results</methodname> <methodparam><type>object</type><parameter>link</parameter></methodparam> </methodsynopsis> <para> <function>mysqli_more_results</function> indique si un ou plusieurs jeux de résultats sont disponibles, générés par un appel antérieur à <function>mysqli_multi_query</function>. </para> </refsect1> <refsect1> <title>Valeurs retournées</title> <para>&return.success;</para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_multi_query</function>, <function>mysqli_next_result</function>, <function>mysqli_store_result</function> et <function>mysqli_use_result</function> </para> </refsect1> <refsect1> <title>Exemple</title> <para> Reportez-vous à <function>mysqli_multi_query</function>. </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-multi-query.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-multi-query.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-multi-query.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-multi-query"> <refnamediv> <refname>mysqli_multi_query</refname> <refname>mysqli->multi_query</refname> <refpurpose>Exécute une requête MySQL multiple</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_multi_query</methodname> <methodparam><type>object</type><parameter>link</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>mysqli</classname></ooclass> <methodsynopsis> <type>bool</type> <methodname>multi_query</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_multi_query</function> exécute une ou plusieurs requêtes, rassemblées dans le paramètre <parameter>query</parameter> par des point-virgules. </para> <para> Pour lire les résultats de la première requête, vous pouvez utiliser les fonctions <function>mysqli_use_result</function> et <function>mysqli_store_result</function>. Tous les autres résultats de requêtes peuvent être atteints avec <function>mysqli_more_results</function> et <function>mysqli_next_result</function>. </para> </refsect1> <refsect1> <title>Valeur de retour</title> <para> &return.success; </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_use_result</function>, <function>mysqli_store_result</function>, <function>mysqli_next_result</function> et <function>mysqli_more_results</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Exemple avec <function>mysqli_multi_query</function></title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT CURRENT_USER();"; $query .= "SELECT Name FROM City ORDER BY ID LIMIT 20, 5"; /* Exécution d'une requête multiple */ if ($mysqli->multi_query($query)) { do { /* Stockage du premier résultat */ if ($result = $mysqli->store_result()) { while ($row = $result->fetch_row()) { printf("%s\n", $row[0]); } $result->close(); } /* Affichage d'une séparation */ if ($mysqli->more_results()) { printf("-----------------\n"); } } while ($mysqli->next_result()); } /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT CURRENT_USER();"; $query .= "SELECT Name FROM City ORDER BY ID LIMIT 20, 5"; /* Exécution d'une requête multiple */ if (mysqli_multi_query($link, $query)) { do { /* Stockage du premier résultat */ if ($result = mysqli_store_result($link)) { while ($row = mysqli_fetch_row($result)) { printf("%s\n", $row[0]); } mysqli_free_result($result); } /* Affichage d'une séparation */ if (mysqli_more_results($link)) { printf("-----------------\n"); } } while (mysqli_next_result($link)); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> L'exemple ci-dessus devrait afficher le résultat suivant : </para> <screen> <![CDATA[ my_user@localhost ----------------- Amersfoort Maastricht Dordrecht Leiden Haarlemmermeer ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-next-result.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-next-result.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-next-result.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-next-result"> <refnamediv> <refname>mysqli_next_result</refname> <refname>mysqli->next_result</refname> <refpurpose>Prépare le prochain résultat d'une requête multiple</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>mysqli_next_result</methodname> <methodparam><type>object</type><parameter>link</parameter></methodparam> </methodsynopsis> <para> <function>mysqli_next_result</function> prépare le prochain jeu de résultat, initialisé par un appel antérieur à <function>mysqli_multi_query</function>, et qui peut être lu par <function>mysqli_store_result</function> ou <function>mysqli_use_result</function>. </para> </refsect1> <refsect1> <title>Valeur retournées</title> <para>&return.success;</para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_multi_query</function>, <function>mysqli_more_results</function>, <function>mysqli_store_result</function> et <function>mysqli_use_result</function> </para> </refsect1> <refsect1> <title>Exemple</title> <para> Reportez-vous à <function>mysqli_multi_query</function>. </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-report.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-report.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-report.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-report"> <refnamediv> <refname>mysqli_report</refname> <refpurpose>Active ou désactive les fonctions de rapport interne</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>mysqli_report</methodname> <methodparam><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> <function>mysqli_report</function> est une fonction puissante, pour améliorer vos requêtes et votre code durant les phases de développement et de tests. En fonction de l'argument <parameter>flags</parameter>, il rapporte des erreurs liées aux appels de fonctions mysqli ou aux requêtes qui n'utilisent pas d'index (ou n'utilisent pas de bon index). </para> <table> <title>Options supportées</title> <tgroup cols='2'> <thead> <row> <entry>Nom</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry><literal>MYSQLI_REPORT_OFF</literal></entry> <entry>Désactive le rapport</entry> </row> <row> <entry><literal>MYSQLI_REPORT_ERROR</literal></entry> <entry>Rapporte les erreurs des fonctions mysqli</entry> </row> <row> <entry><literal>MYSQLI_REPORT_INDEX</literal></entry> <entry>Rapporte si un mauvais index ou pas d'index a été utilisé</entry> </row> <row> <entry><literal>MYSQLI_REPORT_ALL</literal></entry> <entry>Active toutes les options</entry> </row> </tbody> </tgroup> </table> </refsect1> <refsect1> <title>Valeurs retournées</title> <para>&return.success;</para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_debug</function> et <function>mysqli_dump_debug_info</function> </para> </refsect1> <refsect1> <title>Exemple</title> <para> <example> <title>Exemple avec <function>mysqli_report</function></title> <programlisting role="php"> <![CDATA[ <?php /* Active le rapport d'erreur mysqli */ mysqli_report(MYSQLI_REPORT_ALL); $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérifie la connexion */ if (mysqli_connect_errno()) { printf("Conneion échouée : %s\n", mysqli_connect_error()); exit(); } /* Cette requête doit générer une erreur */ $result = $mysqli->query("SELECT Name FROM Nonexistingtable WHERE population > 50000"); /* Cette requête doit générer une alerte */ $result = $mysqli->query("SELECT Name FROM City WHERE population > 50000"); $result->close(); $mysqli->close(); ?> ]]> </programlisting> </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 --> http://cvs.php.net/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-server-end.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-server-end.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-server-end.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-server-end"> <refnamediv> <refname>mysqli_server_end</refname> <refpurpose></refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>void</type><methodname>mysqli_server_end</methodname> <void/> </methodsynopsis> &warn.experimental.func; </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-server-init.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-server-init.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-server-init.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-server-init"> <refnamediv> <refname>mysqli_server_init</refname> <refpurpose>Initialise le serveur MySQL intégré</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>mysqli_server_init</methodname> <void/> </methodsynopsis> &warn.experimental.func; </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-set-opt.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-set-opt.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-set-opt.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-set-opt"> <refnamediv> <refname>mysqli_set_opt</refname> <refpurpose>Alias de <function>mysqli_options</function></refpurpose> </refnamediv> <refsect1> <title>Description</title> <para> <function>mysqli_set_opt</function> est un alias de <function>mysqli_options</function>. </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-sqlstate.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-sqlstate.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-sqlstate.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-sqlstate"> <refnamediv> <refname>mysqli_sqlstate</refname> <refname>mysqli->sqlstate</refname> <refpurpose>Retourne l'erreur SQLSTATE de la dernière opération MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysqli_sqlstate</methodname> <methodparam><type>object</type><parameter>link</parameter></methodparam> </methodsynopsis> <para> <function>mysqli_sqlstate</function> retourne une chaîne contenant le code d'erreur SQLSTATE de la dernière erreur. Le code d'erreur <literal>'00000'</literal> signifie : "pas d'erreur". Les valeurs sont spécifiées par les normes ANSI SQL et ODBC. Pour une liste des valeurs possibles, voyez : <ulink url="&url.mysql.docs.error;">&url.mysql.docs.error;</ulink>. </para> <note> <para> Notez que toutes les erreurs de MySQL n'ont pas encore de correspondance avec les erreurs SQLSTATE. La valeur <literal>HY000</literal> (erreur générale) est utilisée pour les erreurs sans correspondance. </para> </note> </refsect1> <refsect1> <title>Valeurs retournées</title> <para> Retourne une chaîne contenant le code d'erreur SQLSTATE de la dernière erreur. Le code est constitué de 5 caractères : <literal>'00000'</literal> représente l'absence d'erreurs. </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_errno</function> et <function>mysqli_error</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "mon_user", "mon_password", "monde"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } /* La table City existe déjà, nous devrions avoir une erreur */ if (!$mysqli->query("CREATE TABLE City (ID INT, Name VARCHAR(30))")) { printf("Error - SQLSTATE %s.\n", $mysqli->sqlstate); } $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "mon_user", "mon_password", "monde"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } /* La table City existe déjà, nous devrions avoir une erreur */ if (!mysqli_query($link, "CREATE TABLE City (ID INT, Name VARCHAR(30))")) { printf("Error - SQLSTATE %s.\n", mysqli_sqlstate($link)); } mysqli_close($link); ?> ]]> </programlisting> </example> <para> Les exemples ci-dessus doivent produire le résultat suivant : </para> <screen> <![CDATA[ Error - SQLSTATE 42S01. ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-bind-param.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-bind-param.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-bind-param.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-bind-param"> <refnamediv> <refname>mysqli_stmt_bind_param</refname> <refname>stmt->bind_param</refname> <refpurpose>Lie des variables à une requête MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_stmt_bind_param</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> <methodparam><type>string</type><parameter>types</parameter></methodparam> <methodparam><type>mixed</type><parameter>var1</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>var2, ...</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>bool</type> <methodname>bind_param</methodname> <methodparam><type>array</type><parameter>types</parameter></methodparam> <methodparam><type>mixed</type><parameter>var1</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>var2, ...</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_bind_param</function> sert à lier des variables à une requête MySQL préparée par <function>mysql_prepare</function>. La chaîne <parameter>types</parameter> contient un ou plusieurs caractères qui spécifie le type de la variable à lier : <table> <title>Caractère de spécification des types</title> <tgroup cols='2'> <thead> <row> <entry>Caractère</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry>i</entry> <entry>Type entier</entry> </row> <row> <entry>d</entry> <entry>Type double (nombre à virgule flottante)</entry> </row> <row> <entry>s</entry> <entry>Type chaîne</entry> </row> <row> <entry>b</entry> <entry>Type BLOB, qui sera envoyé par paquets</entry> </row> </tbody> </tgroup> </table> </para> <note> <para> Si la taille des données dépasse la taille maximal d'un paquet, (<literal>max_allowed_package</literal>), vous devez spécifier le caractère <literal>b</literal> dans le paramètre <parameter>types</parameter> et utiliser la fonctoin <function>mysqli_stmt_send_long_data</function> pour envoyer le message par paquets. </para> <para> Le nombre de variables et la taille de la chaîne <parameter>types</parameter> doivent correspondre au nombre de variable de la requête. </para> </note> </refsect1> <refsect1> <title>Valeurs retournées</title> <para> &return.success; </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_stmt_bind_result</function>, <function>mysqli_stmt_execute</function>, <function>mysqli_stmt_fetch</function>, <function>mysqli_prepare</function>, <function>mysqli_stmt_send_long_data</function>, <function>mysqli_stmt_errno</function> et <function>mysqli_stmt_error</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli('localhost', 'my_user', 'my_password', 'world'); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $stmt = $mysqli->prepare("INSERT INTO CountryLanguage VALUES (?, ?, ?, ?)"); $stmt->bind_param('sssd', $code, $language, $official, $percent); $code = 'DEU'; $language = 'Bavarian'; $official = "F"; $percent = 11.2; /* Exécution de la requête préparée */ $stmt->execute(); printf("%d Ligne insérée.\n", $stmt->affected_rows); /* Fermeture de la commande */ $stmt->close(); /* Nettoyage de la table CountryLanguage */ $mysqli->query("DELETE FROM CountryLanguage WHERE Language='Bavarian'"); printf("%d Ligne effacée.\n", $mysqli->affected_rows); /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procedural style</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect('localhost', 'my_user', 'my_password', 'world'); /* Vérification de la connexion */ if (!$link) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $stmt = mysqli_prepare($link, "INSERT INTO CountryLanguage VALUES (?, ?, ?, ?)"); mysqli_stmt_bind_param($stmt, 'sssd', $code, $language, $official, $percent); $code = 'DEU'; $language = 'Bavarian'; $official = "F"; $percent = 11.2; /* Exécution de la requête préparée */ mysqi_stmt_execute($stmt); printf("%d Ligne insérée.\n", mysqli_stmt_affected_rows($stmt)); /* Fermeture de la commande */ mysqli_stmt_close($stmt); /* Nettoyage de la table CountryLanguage */ mysqli_query($link, "DELETE FROM CountryLanguage WHERE Language='Bavarian'"); printf("%d Ligne effacée.\n", mysqli_affected_rows($link)); /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> L'exemple ci-dessus devrait produire le résultat suivant : </para> <screen> <![CDATA[ 1 Ligne insérée. 1 Ligne effacée. ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-bind-result.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-bind-result.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-bind-result.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-bind-result"> <refnamediv> <refname>mysqli_stmt_bind_result</refname> <refname>stmt->bind_result</refname> <refpurpose>Lie des variables à un jeu de résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_stnt_bind_result</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> <methodparam><type>mixed</type><parameter>var1</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>var2, ...</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>bool</type> <methodname>bind_result</methodname> <methodparam><type>mixed</type><parameter>var1</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>var2, ...</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_bind_result</function> est utilisé pour associer des colonnes d'un résultat à des variables. Lorsque <function>mysqli_stmt_fetch</function> est appelée pour lire des valeurs, le protocole MySQL place les données dans les variables spécifiées dans le paramètre <parameter>var1, ...</parameter>. </para> <note> <para> Notez que toutes les colonnes doivent être liées avant d'appeler <function>mysqli_stmt_fetch</function>. En fonction du type de valeur de la colonne, le type de variable &php; peut être automatiquement modifié. </para> <para> Une colonne peut être associée ou re-associée à tout moment, même après une lecture partielle du résultat. La nouvelle association prend effet au prochain appel de <function>mysqli_stmt_fetch</function>. </para> </note> </refsect1> <refsect1> <title>Valeur retournées</title> <para> &return.success; </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_stmt_bind_param</function>, <function>mysqli_stmt_execute</function>, <function>mysqli_stmt_fetch</function>, <function>mysqli_prepare</function>, <function>mysqli_stmt_prepare</function>, <function>mysqli_stmt_init</function>, <function>mysqli_stmt_errno</function> et <function>mysqli_stmt_error</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orientié objet</title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } /* prépare la requête */ if ($stmt = $mysqli->prepare("SELECT Code, Name FROM Country ORDER BY Name LIMIT 5")) { $stmt->execute(); /* Association des variables au résultat */ $stmt->bind_result($col1, $col2); /* Lecture des valeurs */ while ($stmt->fetch()) { printf("%s %s\n", $col1, $col2); } /* Fin du résultat */ $stmt->close(); } /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (!$link) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } /* Preparation de la requête */ if ($stmt = mysqli_prepare($link, "SELECT Code, Name FROM Country ORDER BY Name LIMIT 5")) { mysqli_stmt_execute($stmt); /* Association des variables au résultat */ mysqli_stmt_bind_result($stmt, $col1, $col2); /* Lecture des valeurs */ while (mysqli_stmt_fetch($stmt)) { printf("%s %s\n", $col1, $col2); } /* Fermeture de la requête */ mysqli_stmt_close($stmt); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> Les exemples ci-dessus vont produire le résultat suivant : </para> <screen> <![CDATA[ AFG Afghanistan ALB Albania DZA Algeria ASM American Samoa AND Andorra ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-data-seek.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-data-seek.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-data-seek.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-data-seek"> <refnamediv> <refname>mysqli_stmt_data_seek</refname> <refname>stmt->data_seek</refname> <refpurpose>Déplace le pointeur de résultat MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_stmt_data_seek</methodname> <methodparam><type>object</type><parameter>statement</parameter></methodparam> <methodparam><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>bool</type> <methodname>data_seek</methodname> <methodparam><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_data_seek</function> déplace le pointeur du résultat <parameter>statement</parameter> de <parameter>offset</parameter> lignes. <parameter>offset</parameter> doit prendre une valeur entre zéro et le nombre total de ligne moins 1 (0..<function>mysqli_stmt_num_rows</function> - 1). </para> </refsect1> <refsect1> <title>Valeurs retournée</title> <para> &return.success; </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_prepare</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérifie la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER BY Name"; if ($stmt = $mysqli->prepare($query)) { /* Exécute la requête */ $stmt->execute(); /* Lie les variables de résultat */ $stmt->bind_result($name, $code); /* Lit le résultat */ $stmt->store_result(); /* Va à la ligne 400 */ $stmt->data_seek(399); /* Lit une valeur */ $stmt->fetch(); printf ("Ville : %s Pays: %s\n", $name, $code); /* Ferme la commande */ $stmt->close(); } /* Ferme la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procedural style</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérifie la connexion */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER BY Name"; if ($stmt = mysqli_prepare($link, $query)) { /* Exécute la requête */ mysqli_stmt_execute($stmt); /* Lie les variables de résultat */ mysqli_stmt_bind_result($stmt, $name, $code); /* Lit le résultat */ mysqli_stmt_store_result($stmt); /* Va à la ligne 400 */ mysqli_stmt_data_seek($stmt, 399); /* Lit une valeur */ mysqli_stmt_fetch($stmt); printf ("Ville : %s Pays: %s\n", $name, $code); /* Ferme la commande */ mysqli_stmt_close($stmt); } /* Ferme la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> Les exemples ci-dessus vont afficher : </para> <screen> <![CDATA[ Ville : Benin City Pays : NGA ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-execute.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-execute.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-execute.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-execute"> <refnamediv> <refname>mysqli_stmt_execute</refname> <refname>stmt->execute</refname> <refpurpose>Exécute une requête préparée</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_stmt_execute</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>mysql</classname></ooclass> <methodsynopsis> <type>bool</type> <methodname>execute</methodname> <methodparam><type>void</type><parameter></parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_execute</function> exécute une requête qui a été préalablement préparée en utilisant la fonction <function>mysqli_prepare</function>, grâce à la ressource <parameter>stmt</parameter>. Lors de l'exécution, toutes les variables de la requête seront remplacées par les données appropriées. </para> <para> Si la requête est UPDATE, DELETE ou INSERT, le nombre total de lignes affectées est disponible via la fonction <function>mysqli_stmt_affected_rows</function>. De la même façon, si la fonction génère un résultat, il sera disponible via la fonction <function>mysqli_fetch</function>. </para> <note> <para> Lors de l'utilisation de <function>mysqli_stmt_execute</function>, <function>mysqli_fetch</function> doit être utilisée pour lire les données avant de lancer une autre requête. </para> </note> </refsect1> <refsect1> <title>Valeurs retournées</title> <para>&return.success;</para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_prepare</function>, <function>mysqli_stmt_bind_param</function>. </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $mysqli->query("CREATE TABLE myCity LIKE City"); /* Préparation de la commande d'insertion */ $query = "INSERT INTO myCity (Name, CountryCode, District) VALUES (?,?,?)"; $stmt = $mysqli->prepare($query); $stmt->bind_param("sss", $val1, $val2, $val3); $val1 = 'Stuttgart'; $val2 = 'DEU'; $val3 = 'Baden-Wuerttemberg'; /* Exécution de la commande */ $stmt->execute(); $val1 = 'Bordeaux'; $val2 = 'FRA'; $val3 = 'Aquitaine'; /* Exécution de la commande */ $stmt->execute(); /* Fermeture de la commande */ $stmt->close(); /* Lit toutes les données de myCity */ $query = "SELECT Name, CountryCode, District FROM myCity"; if ($result = $mysqli->query($query)) { while ($row = $result->fetch_row()) { printf("%s (%s,%s)\n", $row[0], $row[1], $row[2]); } /* Libère de résultat */ $result->close(); } /* Suppression de la table */ $mysqli->query("DROP TABLE myCity"); /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } mysqli_query($link, "CREATE TABLE myCity LIKE City"); /* Préparation de la commande d'insertion */ $query = "INSERT INTO myCity (Name, CountryCode, District) VALUES (?,?,?)"; $stmt = mysqli_prepare($link, $query); mysqli_stmt_bind_param($stmt, "sss", $val1, $val2, $val3); $val1 = 'Stuttgart'; $val2 = 'DEU'; $val3 = 'Baden-Wuerttemberg'; /* Exécution de la commande */ mysqli_stmt_execute($stmt); $val1 = 'Bordeaux'; $val2 = 'FRA'; $val3 = 'Aquitaine'; /* Exécution de la commande */ mysqli_stmt_execute($stmt); /* Fermeture de la commande */ mysqli_stmt_close($stmt); /* Lit toutes les données de myCity */ $query = "SELECT Name, CountryCode, District FROM myCity"; if ($result = mysqli_query($link, $query)) { while ($row = mysqli_fetch_row($result)) { printf("%s (%s,%s)\n", $row[0], $row[1], $row[2]); } /* Libère de résultat */ mysqli_free_result($result); } /* Suppression de la table */ mysqli_query($link, "DROP TABLE myCity"); /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> Les exemples ci-dessus vont afficher : </para> <screen> <![CDATA[ Stuttgart (DEU,Baden-Wuerttemberg) Bordeaux (FRA,Aquitaine) ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-fetch.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-fetch.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-fetch.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-fetch"> <refnamediv> <refname>mysqli_stmt_fetch</refname> <refname>stmt->fetch</refname> <refpurpose> Lit des résultats depuis une requête MySQL préparée dans des variables liées </refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>mixed</type><methodname>mysqli_stmt_fetch</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>mixed</type> <methodname>fetch</methodname> <methodparam><type>void</type><parameter></parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_fetch</function> retourne une ligne de résultat, en utilisant les variables &php; liées par <function>mysqli_stmt_bind_result</function>. </para> <note> <para> Notez que toutes les colonnes doivent être liées à des variables &php; par l'application avant de pouvoir appeler <function>mysqli_stmt_fetch</function>. </para> </note> </refsect1> <refsect1> <title>Valeurs retournées</title> <table> <title>Valeurs retournées</title> <tgroup cols='2'> <thead> <row> <entry>Valeur</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry>&true;</entry> <entry>Réussite. Les données ont été lues.</entry> </row> <row> <entry>&false;</entry> <entry>Une erreur est survenue.</entry> </row> <row> <entry><literal>&null;</literal></entry> <entry>Il n'y a plus de ligne à lire</entry> </row> </tbody> </tgroup> </table> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_prepare</function>, <function>mysqli_stmt_errno</function>, <function>mysqli_stmt_error</function> et <function>mysqli_stmt_bind_result</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Object oriented style</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérifie la connection */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 150,5"; if ($stmt = $mysqli->prepare($query)) { /* Execution de la requête */ $stmt->execute(); /* Association des variables de résultat */ $stmt->bind_result($name, $code); /* Lecture des valeurs */ while ($stmt->fetch()) { printf ("%s (%s)\n", $name, $code); } /* Fermeture de la commande */ $stmt->close(); } /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procedural style</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérifie la connection */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 150,5"; if ($stmt = mysqli_prepare($link, $query)) { /* execute statement */ mysqli_stmt_execute($stmt); /* Association des variables de résultat */ mysqli_stmt_bind_result($stmt, $name, $code); /* Lecture des valeurs */ while (mysqli_stmt_fetch($stmt)) { printf ("%s (%s)\n", $name, $code); } /* Fermeture de la commande */ mysqli_stmt_close($stmt); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> L'exemple ci-dessus va afficher : </para> <screen> <![CDATA[ Rockford (USA) Tallahassee (USA) Salinas (USA) Santa Clarita (USA) Springfield (USA) ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-free-result.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-free-result.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-free-result.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-free-result"> <refnamediv> <refname>mysqli_stmt_free_result</refname> <refname>stmt->free_result</refname> <refpurpose>Libère le résultat MySQL de la mémoire</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>void</type><methodname>mysqli_stmt_free_result</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>void</type> <methodname>free_result</methodname> <methodparam><type>void</type><parameter></parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_free_result</function> libère le résultat <parameter>stmt</parameter> de la mémoire. <parameter>stmt</parameter> a été obtenu de la fonction <function>mysqli_stmt_store_result</function>. </para> </refsect1> <refsect1> &reftitle.returnvalues; <para> Cette fonction ne retourne pas de valeur. </para> </refsect1> <refsect1> &reftitle.seealso; <para> <function>mysqli_stmt_store_result</function>. </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-init.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-init.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-init.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-init"> <refnamediv> <refname>mysqli_stmt-init</refname> <refname>mysqli->stmt->init</refname> <refpurpose> Initialise une commande MySQL </refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procdural</para> <methodsynopsis> <type>object</type><methodname>mysqli_stmt_init</methodname> <methodparam><type>object</type><parameter>link</parameter></methodparam> </methodsynopsis> <para>Orient objet</para> <classsynopsis> <ooclass><classname>mysqli</classname></ooclass> <methodsynopsis> <type>object</type> <methodname>stmt_init</methodname> <void/> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_init</function> alloue et initialise un objet de commande, utiliser avec <function>mysqli_stmt_prepare</function>. </para> <note> <para> Tous les appels ultrieurs aux fonctions mysqli_stmt_* choueront, si <function>mysqli_stmt_prepare</function> est appel. </para> </note> </refsect1> <refsect1> &reftitle.returnvalues; <para> Retourne un objet. </para> </refsect1> <refsect1> &reftitle.seealso; <para> <function>mysqli_stmt_prepare</function>. </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-num-rows.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-num-rows.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-num-rows.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-num-rows"> <refnamediv> <refname>mysqli_stmt_num_rows</refname> <refname>stmt->num_rows</refname> <refpurpose>Retourne le nombre de lignes d'un rsultat MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>mixed</type><methodname>mysqli_stmt_num_rows</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <fieldsynopsis><type>int</type><varname>num_rows</varname></fieldsynopsis> </classsynopsis> <para> <methodname>mysqli_stmt_num_rows</methodname> retourne le nombre de lignes dans le rsultat <parameter>stmt</parameter>. L'utilisation de la fonction <function>mysqli_stmt_num_rows</function> dpend de l'utilisation ou non de la fonction <function>mysqli_stmt_store_result</function> pour stocker le rsultat dans la ressource de commande. </para> <para> Si vous utilisez <function>mysqli_stmt_store_result</function>, <function>mysqli_stmt_num_rows</function> peut tre appel immdiatement. </para> </refsect1> <refsect1> <title>Valeurs retournes</title> <para> Un entier reprsentant le nombre de lignes dans le rsultat. </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_stmt_affected_rows</function>, <function>mysqli_prepare</function> et <function>mysqli_stmt_store_result</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orient objet</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vrifie la connection */ if (mysqli_connect_errno()) { printf("Connexion choue : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20"; if ($stmt = $mysqli->prepare($query)) { /* Execution de la requte */ $stmt->execute(); /* Stockage du rsultat */ $stmt->store_result(); printf("Nombre de lignes : %d.\n", $stmt->num_rows); /* Fermeture de la commande */ $stmt->close(); } /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procedural style</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vrifie la connection */ if (mysqli_connect_errno()) { printf("Connexion choue : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20"; if ($stmt = mysqli_prepare($link, $query)) { /* Execution de la requte */ mysqli_stmt_execute($stmt); /* Stockage du rsultat */ mysqli_stmt_store_result($stmt); printf("Nombre de lignes : %d.\n", $stmt->num_rows); /* Fermeture de la commande */ mysqli_stmt_close($stmt); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> L'exemple ci-dessus va afficher : </para> <screen> <![CDATA[ Nombre de lignes : 20. ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-param-count.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-param-count.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-param-count.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-param-count"> <refnamediv> <refname>mysqli_stmt_param_count</refname> <refname>stmt->param_count</refname> <refpurpose>Retourne le nombre de paramètre d'une commande MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>int</type><methodname>mysqli_stmt_param_count</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <fieldsynopsis><type>int</type><varname>param_count</varname></fieldsynopsis> </classsynopsis> <para> <function>mysqli_stmt_param_count</function> retourne le nombre de variables attendues dans la requête préparée <parameter>stmt</parameter>. </para> </refsect1> <refsect1> &reftitle.returnvalues; <para> Retourne un entier représentant le nombre de paramètres. </para> </refsect1> <refsect1> &reftitle.seealso; <para> <function>mysqli_prepare</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } if ($stmt = $mysqli->prepare("SELECT Name FROM Country WHERE Name=? OR Code=?")) { $marker = $stmt->param_count; printf("La requête a %d variables.\n", $marker); /* Fermeture de la requête */ $stmt->close(); } /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } if ($stmt = mysqli_prepare($link, "SELECT Name FROM Country WHERE Name=? OR Code=?")) { $marker = mysqli_stmt_param_count($stmt); printf("La requête a %d variables.\n", $marker); /* Fermeture de la requête */ mysqli_stmt_close($stmt); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> Les exemples ci-dessus vont afficher : </para> <screen> <![CDATA[ La requête a 2 variables. ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-prepare.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-prepare.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-prepare.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-prepare"> <refnamediv> <refname>mysqli_stmt_prepare</refname> <refname>stmt->prepare</refname> <refpurpose> Prépare une requête SQL pour l'exécution </refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_stmt_prepare</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>mixed</type> <methodname>prepare</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_prepare</function> prépare la requête SQL <parameter>query</parameter>, pour la session de travail <parameter>stmt</parameter>. <parameter>stmt</parameter> doit avoir été alloué par <function>mysqli_stmt_init</function>. La requête doit être une seule requête SQL. </para> <note> <para> Il ne faut pas ajouter de point-virgule ou de <literal>\g</literal> à la fin de la requête. </para> </note> <para> Le paramètre <parameter>query</parameter> peut inclure une ou plusieurs variables SQL, en utilisant des points d'interrogation (<literal>?</literal>) aux bons endroits. </para> <note> <para> Les variables SQL ne sont possibles que dans certaines clauses de la requête SQL. Par exemple, elles peuvent être placées dans des clause VALUES() d'une requête INSERT (pour spécifier une valeur à insérer), ou dans une clause de condition WHERE. </para> <para> Cependant, elles ne sont pas autorisées pour les identifiants (de tables ou de colonnes), dans les listes de colonnes d'un SELECT, ou pour spécifier des opérateurs comme <literal>=</literal>. Cette dernière restriction est liée au fait qu'il est impossible de déterminer le type. En général, les variables SQL ne sont valides que dans les commandes de manipulations de données (Data Manipulation Languange (DML)), et non dans les structures du langages SQL (Data Defination Language (DDL)). </para> </note> <para> Les variables SQL doivent être associées à une variable &php; à l'aide de la fonction <function>mysqli_stmt_bind_param</function> et/ou <function>mysqli_stmt_bind_result</function>, avant d'exécuter la requête. </para> </refsect1> <refsect1> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1> &reftitle.seealso; <para> <function>mysqli_stmt_init</function>, <function>mysqli_stmt_execute</function>, <function>mysqli_stmt_fetch</function>, <function>mysqli_stmt_bind_param</function>, <function>mysqli_stmt_bind_result</function> et <function>mysqli_stmt_close</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } $city = "Amersfoort"; /* Création d'une requête préparée */ $stmt = $mysqli->stmt_init(); if ($stmt->prepare("SELECT District FROM City WHERE Name=?")) { /* Association des variables SQL */ $stmt->bind_param("s", $city); /* Exécution de la requête */ $stmt->execute(); /* Association des variables de résultats */ $stmt->bind_result($district); /* Lecture des valeurs */ $stmt->fetch(); printf("%s est dans le district de %s\n", $city, $district); /* Fermeture de la commande */ $stmt->close(); } /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } $city = "Amersfoort"; /* Création d'une requête préparée */ $stmt = mysqli_stmt_init(); if ($stmt = mysqli_stmt_prepare($stmt, "SELECT District FROM City WHERE Name=?")) { /* Association des variables SQL */ mysqli_stmt_bind_param($stmt, "s", $city); /* Exécution de la requête */ mysqli_stmt_execute($stmt); /* Association des variables de résultats */ mysqli_stmt_bind_result($stmt, $district); /* Lecture des valeurs */ mysqli_stmt_fetch($stmt); printf("%s est dans le district de %s\n", $city, $district); /* Fermeture de la commande */ mysqli_stmt_close($stmt); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> L'exemple ci-dessus va afficher : </para> <screen> <![CDATA[ Amersfoort est dans le district de Utrecht ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-result-metadata.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-result-metadata.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-result-metadata.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-result-metadata"> <refnamediv> <refname>mysqli_stmt_result_metadata</refname> <refpurpose>Retourne les mta-donnes de prparation de requte MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procdural</para> <methodsynopsis> <type>mixed</type><methodname>mysqli_stmt_result_metadata</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <para>Orient objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>mixed</type> <methodname>result_metadata</methodname> <methodparam><type>void</type><parameter></parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Si une commande a t prpare par <function>mysqli_prepare</function>, et qu'elle produira un rsultat, <function>mysqli_stmt_result_metadata</function> retourne l'objet de rsultat qui sera utilis pour lire les mta-donnes, comme le nombre de champs et les informations de colonnes. </para> <note> <para> Ce rsultat peut tre pass comme argument toute les fonctions qui demandent un champ, pour y lire les mta-donnes : <itemizedlist> <listitem><para><function>mysqli_num_fields</function></para></listitem> <listitem><para><function>mysqli_fetch_field</function></para></listitem> <listitem><para><function>mysqli_fetch_field_direct</function></para></listitem> <listitem><para><function>mysqli_fetch_fields</function></para></listitem> <listitem><para><function>mysqli_field_count</function></para></listitem> <listitem><para><function>mysqli_field_seek</function></para></listitem> <listitem><para><function>mysqli_field_tell</function></para></listitem> <listitem><para><function>mysqli_free_result</function></para></listitem> </itemizedlist> </para> </note> <para> Il est recommand de librer la ressource de rsultat lorsque vous avez termin de l'utilis, en la passant la fonction <function>mysqli_free_result</function> </para> <note> <para> Le jeu de rsultat retourn par <function>mysqli_stmt_result_metadata</function> ne contient que des mta-donnes. Il ne contient aucune ligne de rsultat. Ces lignes sont obtenues en utilisant la fonction <function>mysqli_fetch</function>. </para> </note> </refsect1> <refsect1> &reftitle.returnvalues; <para> <function>mysqli_stmt_result_metadata</function> retourne un objet de rsultat, ou &false; si une erreur survient. </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_prepare</function> et <function>mysqli_free_result</function> </para> </refsect1> <refsect1> <title>Exemple</title> <para> <example> <title>Orient objet</title> <programlisting role='php'> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "test"); $mysqli->query("DROP TABLE IF EXISTS friends"); $mysqli->query("CREATE TABLE friends (id int, name varchar(20))"); $mysqli->query("INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')"); $stmt = $mysqli->prepare("SELECT id, name FROM friends"); $stmt->execute(); /* Lit les mta-donnes de rsultat */ $result = $stmt->result_metadata(); /* Lit les informations d'un champ, depuis les mta-donnes */ $field = $result->fetch_field(); printf("Nom du champ : %s\n", $field->name); /* Libration du rsultat */ $result->close(); /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procdural</title> <programlisting role='php'> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "test"); mysqli_query($link, "DROP TABLE IF EXISTS friends"); mysqli_query($link, "CREATE TABLE friends (id int, name varchar(20))"); mysqli_query($link, "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')"); $stmt = mysqli_prepare($link, "SELECT id, name FROM friends"); mysqli_stmt_execute($stmt); /* Lit les mta-donnes de rsultat */ $result = mysqli_stmt_result_metadata($stmt); /* Lit les informations d'un champ, depuis les mta-donnes */ $field = mysqli_fetch_field($result); printf("Nom du champ : %s\n", $field->name); /* Libration du rsultat */ mysqli_free_result($result); /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-send-long-data.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-send-long-data.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-send-long-data.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-send-long-data"> <refnamediv> <refname>mysqli_stmt_send_long_data</refname> <refname>stmt->send_long_data</refname> <refpurpose>Envoie des données MySQL par paquet</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_stmt_send_long_data</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> <methodparam><type>int</type><parameter>param_nr</parameter></methodparam> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>stmt_send_long_data</methodname> <methodparam><type>int</type><parameter>param_nr</parameter></methodparam> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_send_long_data</function> envoie les données au serveur par paquets, si la taille des données excède la limite de <literal>max_allowed_packet</literal>. Cette fonctoin peut être appelée plusieurs fois pour envoyer les données textes ou binaires de champs comme les BLOB ou TEXT. </para> <para> <parameter>param_nr</parameter> indique quel paramètre doit être associé avec quelles données. Les paramètres sont numérotés à partir de 0. <parameter>data</parameter> est une chaîne de caractères, contenant les données à envoyer. </para> </refsect1> <refsect1> <title>Valeurs retournées</title> <para>&return.success;</para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_prepare</function>, <function>mysqli_stmt_bind_param</function> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-sqlstate.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-sqlstate.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-sqlstate.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-sqlstate"> <refnamediv> <refname>mysqli_stmt_sqlstate</refname> <refpurpose>Retourne le code SQLSTATE de la dernière opération MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysqli_stmt_sqlstate</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <para> <function>mysqli_stmt_sqlstate</function> retourne une chaîne contenant le code d'erreur SQLSTATE de la commande la plus récente qui a été préparée. Le code d'erreur est constitué de 5 caractères. <literal>'00000'</literal> Les valeurs des codes d'erreurs sont spécifiées par les normes ANSI SQL et ODBC. Pour la liste complète des valeurs, voyez le fichier <ulink url="&url.mysql.docs.error;">&url.mysql.docs.error;</ulink>. </para> <note> <para> Notez que toutes les erreurs MySQL n'ont pas encore de correspondance en SQLSTATE. La valeur <literal>HY000</literal> (erreur générale) est utilisée pour les erreurs sans correspondance. </para> </note> </refsect1> <refsect1> <title>Valeurs retournées</title> <para> Retourne la chaîne contenant le code d'erreur SQLSTATE. Le code d'erreur est constitué de 5 caractères. <literal>'00000'</literal> représente l'absence d'erreur. </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_stmt_errno</function> et <function>mysqli_stmt_error</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérifie la connection */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $mysqli->query("CREATE TABLE myCountry LIKE Country"); $mysqli->query("INSERT INTO myCountry SELECT * FROM Country"); $query = "SELECT Name, Code FROM myCountry ORDER BY Name"; if ($stmt = $mysqli->prepare($query)) { /* Effacement de la table */ $mysqli->query("DROP TABLE myCountry"); /* Execution de la requête */ $stmt->execute(); printf("Erreur : %s.\n", $stmt->sqlstate); /* Fermeture de la commande */ $stmt->close(); } /* Fermture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérifie la connection */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } mysqli_query($link, "CREATE TABLE myCountry LIKE Country"); mysqli_query($link, "INSERT INTO myCountry SELECT * FROM Country"); $query = "SELECT Name, Code FROM myCountry ORDER BY Name"; if ($stmt = mysqli_prepare($link, $query)) { /* Effacement de la table */ mysqli_query($link, "DROP TABLE myCountry"); /* Execution de la requête */ mysqli_stmt_execute($stmt); printf("Erreur : %s.\n", mysqli_stmt_sqlstate($stmt)); /* Fermeture de la commande */ mysqli_stmt_close($stmt); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> L'exemple ci-dessus va afficher : </para> <screen> <![CDATA[ Erreur : 42S02. ]]> </screen> </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/diff.php/phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml diff -u phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml:1.7 phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml:1.8 --- phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml:1.7 Tue Feb 24 13:12:15 2004 +++ phpdoc-fr/reference/mysqli/functions/mysqli-affected-rows.xml Wed Mar 31 11:09:35 2004 @@ -1,38 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> <refentry id="function.mysqli-affected-rows"> <refnamediv> <refname>mysqli_affected_rows</refname> <refpurpose> - Retourne le nombre de ligne affectées par la dernière - opération MySQL + Retourne le nombre de ligne affectÈes par la derniËre + opÈration MySQL </refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>mysqli_affected_rows</methodname> - <methodparam><type>resource</type><parameter>link</parameter></methodparam> - </methodsynopsis> + <para>ProcÈdural</para> + <methodsynopsis> + <type>mixed</type><methodname>mysqli_affected_rows</methodname> + <methodparam><type>object</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>OrientÈ objet</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <fieldsynopsis><type>mixed</type><varname>affected_rows</varname></fieldsynopsis> + </classsynopsis> <para> <function>mysqli_affected_rows</function> retourne le nombre de lignes - affectées par la dernière requête INSERT, UPDATE, ou - DELETE associée au paramètre <parameter>link</parameter>. - Si la dernière requête était invalide, cette fonction + affectÈes par la derniËre requête INSERT, UPDATE, ou + DELETE associÈe au paramËtre <parameter>link</parameter>. + Si la derniËre requête Ètait invalide, cette fonction retournera -1. </para> <note> <para> Lorsque vous supprimez tout le contenu de la table (i.e. 'DELETE FROM - foo'), cette fonction ne retourne pas le nombre de lignes effacées. + foo'), cette fonction ne retourne pas le nombre de lignes effacÈes. </para> </note> <para> La fonction <function>mysqli_affected_rows</function> ne fonctionne que pour les requêtes qui modifient une table. Pour connaître le - nombre de lignes retournées par une requête SELECT, utilisez + nombre de lignes retournÈes par une requête SELECT, utilisez la fonction <function>mysqli_num_rows</function>. </para> <para> @@ -46,22 +52,22 @@ die("Impossible de se connecter : " . mysqli_error()); mysqli_select_db("mydb"); - /* cela devrait retourner le nombre correct de lignes effacées */ + /* cela devrait retourner le nombre correct de lignes effacÈes */ mysqli_query("DELETE FROM mytable WHERE id < 10"); - printf ("Enregistrements effacés : %d\n", mysqli_affected_rows()); + printf ("Enregistrements effacÈs : %d\n", mysqli_affected_rows()); /* sans la clause where dans la requête, cela devrait retourner 0 */ mysqli_query("DELETE FROM mytable"); - printf ("Enregistrements effacés : %d\n", mysqli_affected_rows()); + printf ("Enregistrements effacÈs : %d\n", mysqli_affected_rows()); ?> ]]> </programlisting> <para> - L'exemple précédent produira ce qui suit : + L'exemple prÈcÈdent produira ce qui suit : <screen> <![CDATA[ -Enregistrements effacés : 10 -Enregistrements effacés : 0 +Enregistrements effacÈs : 10 +Enregistrements effacÈs : 0 ]]> </screen> </para> @@ -83,7 +89,7 @@ ]]> </programlisting> <para> - L'exemple précédent produira ce qui suit : + L'exemple prÈcÈdent produira ce qui suit : <screen> <![CDATA[ Lignes mises à jour : 10 http://cvs.php.net/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-embedded-connect.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-embedded-connect.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-embedded-connect.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-embedded-connect"> <refnamediv> <refname>mysqli_embedded_connect</refname> <refpurpose>Ouvre une connexion avec un serveur MySQL intégré</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>object</type><methodname>mysqli_embedded_connect</methodname> <methodparam><type>void</type><parameter></parameter></methodparam> </methodsynopsis> &warn.experimental.func; </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-escape-string.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-escape-string.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-escape-string.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-escape-string"> <refnamediv> <refname>mysqli_escape_string</refname> <refpurpose>Alias de <function>mysqli_real_escape_string</function></refpurpose> </refnamediv> <refsect1> <title>Description</title> <para> <function>mysqli_escape_string</function> est un alias de <function>mysqli_real_escape_string</function>. </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-get-client-version.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-get-client-version.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-get-client-version.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-get-client-version"> <refnamediv> <refname>mysqli_get_client_version</refname> <refpurpose>Lit les informations du client MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>mysqli_get_client_version</methodname> <void/> </methodsynopsis> <para> <function>mysqli_get_client_version</function> retourne la version du client MySQL sous la forme d'un entier. </para> </refsect1> <refsect1> <title>Valeur retournée</title> <para> Un nombre qui représente la version de la bibliothèque cliente MySQL dans ce format : <literal>version_principale*10000 + version_mineure *100 + sous_version</literal>. Par exemple, la version 4.1.0 est retournée sous la forme 40100. </para> <para> Cette fonction est pratique pour déterminer la version de la bibliothèque cliente, si vous recherchez des fonctionnalités spécifiques. </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_get_client_info</function>, <function>mysqli_get_server_info</function> et <function>mysqli_get_server_version</function> </para> </refsect1> <refsect1> <title>Exemple</title> <para> <example> <title>Exemple avec <function>mysqli_get_client_version</function></title> <programlisting role='php'> <![CDATA[ <?php /* Nous n'avons pas besoin d'une connexion pour déterminer la version de la bibliothèque cliente mysql */ printf("Version de la bibliothèque : %d\n", mysqli_get_client_version()); ?> ]]> </programlisting> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-get-metadata.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-get-metadata.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-get-metadata.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-get-metadata"> <refnamediv> <refname>mysqli_get_metadata</refname> <refpurpose>Alias de <function>mysqli_stmt_result_metadata</function></refpurpose> </refnamediv> <refsect1> <title>Description</title> <para> <function>mysqli_get_metadata</function> est un alias de <function>mysqli_stmt_result_metadata</function>. Pour une description détaillée, reportez-vous à la documentation de <function>mysqli_stmt_result_metadata</function>. </para> <note> <para> <function>mysqli_get_metadata</function> est obsolète, et sera supprimé bientôt. </para> </note> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_stmt_result_metadata</function> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-more-results.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-more-results.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-more-results.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-more-results"> <refnamediv> <refname>mysqli_more_results</refname> <refname>mysqli->more_results</refname> <refpurpose>Vérifie s'il y a d'autres jeux de résultats MySQL disponibles</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>mysqli_more_results</methodname> <methodparam><type>object</type><parameter>link</parameter></methodparam> </methodsynopsis> <para> <function>mysqli_more_results</function> indique si un ou plusieurs jeux de résultats sont disponibles, générés par un appel antérieur à <function>mysqli_multi_query</function>. </para> </refsect1> <refsect1> <title>Valeurs retournées</title> <para>&return.success;</para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_multi_query</function>, <function>mysqli_next_result</function>, <function>mysqli_store_result</function> et <function>mysqli_use_result</function> </para> </refsect1> <refsect1> <title>Exemple</title> <para> Reportez-vous à <function>mysqli_multi_query</function>. </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-multi-query.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-multi-query.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-multi-query.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-multi-query"> <refnamediv> <refname>mysqli_multi_query</refname> <refname>mysqli->multi_query</refname> <refpurpose>Exécute une requête MySQL multiple</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_multi_query</methodname> <methodparam><type>object</type><parameter>link</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>mysqli</classname></ooclass> <methodsynopsis> <type>bool</type> <methodname>multi_query</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_multi_query</function> exécute une ou plusieurs requêtes, rassemblées dans le paramètre <parameter>query</parameter> par des point-virgules. </para> <para> Pour lire les résultats de la première requête, vous pouvez utiliser les fonctions <function>mysqli_use_result</function> et <function>mysqli_store_result</function>. Tous les autres résultats de requêtes peuvent être atteints avec <function>mysqli_more_results</function> et <function>mysqli_next_result</function>. </para> </refsect1> <refsect1> <title>Valeur de retour</title> <para> &return.success; </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_use_result</function>, <function>mysqli_store_result</function>, <function>mysqli_next_result</function> et <function>mysqli_more_results</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Exemple avec <function>mysqli_multi_query</function></title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT CURRENT_USER();"; $query .= "SELECT Name FROM City ORDER BY ID LIMIT 20, 5"; /* Exécution d'une requête multiple */ if ($mysqli->multi_query($query)) { do { /* Stockage du premier résultat */ if ($result = $mysqli->store_result()) { while ($row = $result->fetch_row()) { printf("%s\n", $row[0]); } $result->close(); } /* Affichage d'une séparation */ if ($mysqli->more_results()) { printf("-----------------\n"); } } while ($mysqli->next_result()); } /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT CURRENT_USER();"; $query .= "SELECT Name FROM City ORDER BY ID LIMIT 20, 5"; /* Exécution d'une requête multiple */ if (mysqli_multi_query($link, $query)) { do { /* Stockage du premier résultat */ if ($result = mysqli_store_result($link)) { while ($row = mysqli_fetch_row($result)) { printf("%s\n", $row[0]); } mysqli_free_result($result); } /* Affichage d'une séparation */ if (mysqli_more_results($link)) { printf("-----------------\n"); } } while (mysqli_next_result($link)); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> L'exemple ci-dessus devrait afficher le résultat suivant : </para> <screen> <![CDATA[ my_user@localhost ----------------- Amersfoort Maastricht Dordrecht Leiden Haarlemmermeer ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-next-result.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-next-result.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-next-result.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-next-result"> <refnamediv> <refname>mysqli_next_result</refname> <refname>mysqli->next_result</refname> <refpurpose>Prépare le prochain résultat d'une requête multiple</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>mysqli_next_result</methodname> <methodparam><type>object</type><parameter>link</parameter></methodparam> </methodsynopsis> <para> <function>mysqli_next_result</function> prépare le prochain jeu de résultat, initialisé par un appel antérieur à <function>mysqli_multi_query</function>, et qui peut être lu par <function>mysqli_store_result</function> ou <function>mysqli_use_result</function>. </para> </refsect1> <refsect1> <title>Valeur retournées</title> <para>&return.success;</para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_multi_query</function>, <function>mysqli_more_results</function>, <function>mysqli_store_result</function> et <function>mysqli_use_result</function> </para> </refsect1> <refsect1> <title>Exemple</title> <para> Reportez-vous à <function>mysqli_multi_query</function>. </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-report.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-report.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-report.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-report"> <refnamediv> <refname>mysqli_report</refname> <refpurpose>Active ou désactive les fonctions de rapport interne</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>mysqli_report</methodname> <methodparam><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> <function>mysqli_report</function> est une fonction puissante, pour améliorer vos requêtes et votre code durant les phases de développement et de tests. En fonction de l'argument <parameter>flags</parameter>, il rapporte des erreurs liées aux appels de fonctions mysqli ou aux requêtes qui n'utilisent pas d'index (ou n'utilisent pas de bon index). </para> <table> <title>Options supportées</title> <tgroup cols='2'> <thead> <row> <entry>Nom</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry><literal>MYSQLI_REPORT_OFF</literal></entry> <entry>Désactive le rapport</entry> </row> <row> <entry><literal>MYSQLI_REPORT_ERROR</literal></entry> <entry>Rapporte les erreurs des fonctions mysqli</entry> </row> <row> <entry><literal>MYSQLI_REPORT_INDEX</literal></entry> <entry>Rapporte si un mauvais index ou pas d'index a été utilisé</entry> </row> <row> <entry><literal>MYSQLI_REPORT_ALL</literal></entry> <entry>Active toutes les options</entry> </row> </tbody> </tgroup> </table> </refsect1> <refsect1> <title>Valeurs retournées</title> <para>&return.success;</para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_debug</function> et <function>mysqli_dump_debug_info</function> </para> </refsect1> <refsect1> <title>Exemple</title> <para> <example> <title>Exemple avec <function>mysqli_report</function></title> <programlisting role="php"> <![CDATA[ <?php /* Active le rapport d'erreur mysqli */ mysqli_report(MYSQLI_REPORT_ALL); $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérifie la connexion */ if (mysqli_connect_errno()) { printf("Conneion échouée : %s\n", mysqli_connect_error()); exit(); } /* Cette requête doit générer une erreur */ $result = $mysqli->query("SELECT Name FROM Nonexistingtable WHERE population > 50000"); /* Cette requête doit générer une alerte */ $result = $mysqli->query("SELECT Name FROM City WHERE population > 50000"); $result->close(); $mysqli->close(); ?> ]]> </programlisting> </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 --> http://cvs.php.net/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-server-end.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-server-end.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-server-end.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-server-end"> <refnamediv> <refname>mysqli_server_end</refname> <refpurpose></refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>void</type><methodname>mysqli_server_end</methodname> <void/> </methodsynopsis> &warn.experimental.func; </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-server-init.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-server-init.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-server-init.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-server-init"> <refnamediv> <refname>mysqli_server_init</refname> <refpurpose>Initialise le serveur MySQL intégré</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>bool</type><methodname>mysqli_server_init</methodname> <void/> </methodsynopsis> &warn.experimental.func; </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-set-opt.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-set-opt.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-set-opt.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-set-opt"> <refnamediv> <refname>mysqli_set_opt</refname> <refpurpose>Alias de <function>mysqli_options</function></refpurpose> </refnamediv> <refsect1> <title>Description</title> <para> <function>mysqli_set_opt</function> est un alias de <function>mysqli_options</function>. </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-sqlstate.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-sqlstate.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-sqlstate.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-sqlstate"> <refnamediv> <refname>mysqli_sqlstate</refname> <refname>mysqli->sqlstate</refname> <refpurpose>Retourne l'erreur SQLSTATE de la dernière opération MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysqli_sqlstate</methodname> <methodparam><type>object</type><parameter>link</parameter></methodparam> </methodsynopsis> <para> <function>mysqli_sqlstate</function> retourne une chaîne contenant le code d'erreur SQLSTATE de la dernière erreur. Le code d'erreur <literal>'00000'</literal> signifie : "pas d'erreur". Les valeurs sont spécifiées par les normes ANSI SQL et ODBC. Pour une liste des valeurs possibles, voyez : <ulink url="&url.mysql.docs.error;">&url.mysql.docs.error;</ulink>. </para> <note> <para> Notez que toutes les erreurs de MySQL n'ont pas encore de correspondance avec les erreurs SQLSTATE. La valeur <literal>HY000</literal> (erreur générale) est utilisée pour les erreurs sans correspondance. </para> </note> </refsect1> <refsect1> <title>Valeurs retournées</title> <para> Retourne une chaîne contenant le code d'erreur SQLSTATE de la dernière erreur. Le code est constitué de 5 caractères : <literal>'00000'</literal> représente l'absence d'erreurs. </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_errno</function> et <function>mysqli_error</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "mon_user", "mon_password", "monde"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } /* La table City existe déjà, nous devrions avoir une erreur */ if (!$mysqli->query("CREATE TABLE City (ID INT, Name VARCHAR(30))")) { printf("Error - SQLSTATE %s.\n", $mysqli->sqlstate); } $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "mon_user", "mon_password", "monde"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } /* La table City existe déjà, nous devrions avoir une erreur */ if (!mysqli_query($link, "CREATE TABLE City (ID INT, Name VARCHAR(30))")) { printf("Error - SQLSTATE %s.\n", mysqli_sqlstate($link)); } mysqli_close($link); ?> ]]> </programlisting> </example> <para> Les exemples ci-dessus doivent produire le résultat suivant : </para> <screen> <![CDATA[ Error - SQLSTATE 42S01. ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-bind-param.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-bind-param.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-bind-param.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-bind-param"> <refnamediv> <refname>mysqli_stmt_bind_param</refname> <refname>stmt->bind_param</refname> <refpurpose>Lie des variables à une requête MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_stmt_bind_param</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> <methodparam><type>string</type><parameter>types</parameter></methodparam> <methodparam><type>mixed</type><parameter>var1</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>var2, ...</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>bool</type> <methodname>bind_param</methodname> <methodparam><type>array</type><parameter>types</parameter></methodparam> <methodparam><type>mixed</type><parameter>var1</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>var2, ...</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_bind_param</function> sert à lier des variables à une requête MySQL préparée par <function>mysql_prepare</function>. La chaîne <parameter>types</parameter> contient un ou plusieurs caractères qui spécifie le type de la variable à lier : <table> <title>Caractère de spécification des types</title> <tgroup cols='2'> <thead> <row> <entry>Caractère</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry>i</entry> <entry>Type entier</entry> </row> <row> <entry>d</entry> <entry>Type double (nombre à virgule flottante)</entry> </row> <row> <entry>s</entry> <entry>Type chaîne</entry> </row> <row> <entry>b</entry> <entry>Type BLOB, qui sera envoyé par paquets</entry> </row> </tbody> </tgroup> </table> </para> <note> <para> Si la taille des données dépasse la taille maximal d'un paquet, (<literal>max_allowed_package</literal>), vous devez spécifier le caractère <literal>b</literal> dans le paramètre <parameter>types</parameter> et utiliser la fonctoin <function>mysqli_stmt_send_long_data</function> pour envoyer le message par paquets. </para> <para> Le nombre de variables et la taille de la chaîne <parameter>types</parameter> doivent correspondre au nombre de variable de la requête. </para> </note> </refsect1> <refsect1> <title>Valeurs retournées</title> <para> &return.success; </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_stmt_bind_result</function>, <function>mysqli_stmt_execute</function>, <function>mysqli_stmt_fetch</function>, <function>mysqli_prepare</function>, <function>mysqli_stmt_send_long_data</function>, <function>mysqli_stmt_errno</function> et <function>mysqli_stmt_error</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli('localhost', 'my_user', 'my_password', 'world'); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $stmt = $mysqli->prepare("INSERT INTO CountryLanguage VALUES (?, ?, ?, ?)"); $stmt->bind_param('sssd', $code, $language, $official, $percent); $code = 'DEU'; $language = 'Bavarian'; $official = "F"; $percent = 11.2; /* Exécution de la requête préparée */ $stmt->execute(); printf("%d Ligne insérée.\n", $stmt->affected_rows); /* Fermeture de la commande */ $stmt->close(); /* Nettoyage de la table CountryLanguage */ $mysqli->query("DELETE FROM CountryLanguage WHERE Language='Bavarian'"); printf("%d Ligne effacée.\n", $mysqli->affected_rows); /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procedural style</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect('localhost', 'my_user', 'my_password', 'world'); /* Vérification de la connexion */ if (!$link) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $stmt = mysqli_prepare($link, "INSERT INTO CountryLanguage VALUES (?, ?, ?, ?)"); mysqli_stmt_bind_param($stmt, 'sssd', $code, $language, $official, $percent); $code = 'DEU'; $language = 'Bavarian'; $official = "F"; $percent = 11.2; /* Exécution de la requête préparée */ mysqi_stmt_execute($stmt); printf("%d Ligne insérée.\n", mysqli_stmt_affected_rows($stmt)); /* Fermeture de la commande */ mysqli_stmt_close($stmt); /* Nettoyage de la table CountryLanguage */ mysqli_query($link, "DELETE FROM CountryLanguage WHERE Language='Bavarian'"); printf("%d Ligne effacée.\n", mysqli_affected_rows($link)); /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> L'exemple ci-dessus devrait produire le résultat suivant : </para> <screen> <![CDATA[ 1 Ligne insérée. 1 Ligne effacée. ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-bind-result.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-bind-result.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-bind-result.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-bind-result"> <refnamediv> <refname>mysqli_stmt_bind_result</refname> <refname>stmt->bind_result</refname> <refpurpose>Lie des variables à un jeu de résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_stnt_bind_result</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> <methodparam><type>mixed</type><parameter>var1</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>var2, ...</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>bool</type> <methodname>bind_result</methodname> <methodparam><type>mixed</type><parameter>var1</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>var2, ...</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_bind_result</function> est utilisé pour associer des colonnes d'un résultat à des variables. Lorsque <function>mysqli_stmt_fetch</function> est appelée pour lire des valeurs, le protocole MySQL place les données dans les variables spécifiées dans le paramètre <parameter>var1, ...</parameter>. </para> <note> <para> Notez que toutes les colonnes doivent être liées avant d'appeler <function>mysqli_stmt_fetch</function>. En fonction du type de valeur de la colonne, le type de variable &php; peut être automatiquement modifié. </para> <para> Une colonne peut être associée ou re-associée à tout moment, même après une lecture partielle du résultat. La nouvelle association prend effet au prochain appel de <function>mysqli_stmt_fetch</function>. </para> </note> </refsect1> <refsect1> <title>Valeur retournées</title> <para> &return.success; </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_stmt_bind_param</function>, <function>mysqli_stmt_execute</function>, <function>mysqli_stmt_fetch</function>, <function>mysqli_prepare</function>, <function>mysqli_stmt_prepare</function>, <function>mysqli_stmt_init</function>, <function>mysqli_stmt_errno</function> et <function>mysqli_stmt_error</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orientié objet</title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } /* prépare la requête */ if ($stmt = $mysqli->prepare("SELECT Code, Name FROM Country ORDER BY Name LIMIT 5")) { $stmt->execute(); /* Association des variables au résultat */ $stmt->bind_result($col1, $col2); /* Lecture des valeurs */ while ($stmt->fetch()) { printf("%s %s\n", $col1, $col2); } /* Fin du résultat */ $stmt->close(); } /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (!$link) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } /* Preparation de la requête */ if ($stmt = mysqli_prepare($link, "SELECT Code, Name FROM Country ORDER BY Name LIMIT 5")) { mysqli_stmt_execute($stmt); /* Association des variables au résultat */ mysqli_stmt_bind_result($stmt, $col1, $col2); /* Lecture des valeurs */ while (mysqli_stmt_fetch($stmt)) { printf("%s %s\n", $col1, $col2); } /* Fermeture de la requête */ mysqli_stmt_close($stmt); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> Les exemples ci-dessus vont produire le résultat suivant : </para> <screen> <![CDATA[ AFG Afghanistan ALB Albania DZA Algeria ASM American Samoa AND Andorra ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-data-seek.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-data-seek.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-data-seek.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-data-seek"> <refnamediv> <refname>mysqli_stmt_data_seek</refname> <refname>stmt->data_seek</refname> <refpurpose>Déplace le pointeur de résultat MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_stmt_data_seek</methodname> <methodparam><type>object</type><parameter>statement</parameter></methodparam> <methodparam><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>bool</type> <methodname>data_seek</methodname> <methodparam><type>int</type><parameter>offset</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_data_seek</function> déplace le pointeur du résultat <parameter>statement</parameter> de <parameter>offset</parameter> lignes. <parameter>offset</parameter> doit prendre une valeur entre zéro et le nombre total de ligne moins 1 (0..<function>mysqli_stmt_num_rows</function> - 1). </para> </refsect1> <refsect1> <title>Valeurs retournée</title> <para> &return.success; </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_prepare</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérifie la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER BY Name"; if ($stmt = $mysqli->prepare($query)) { /* Exécute la requête */ $stmt->execute(); /* Lie les variables de résultat */ $stmt->bind_result($name, $code); /* Lit le résultat */ $stmt->store_result(); /* Va à la ligne 400 */ $stmt->data_seek(399); /* Lit une valeur */ $stmt->fetch(); printf ("Ville : %s Pays: %s\n", $name, $code); /* Ferme la commande */ $stmt->close(); } /* Ferme la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procedural style</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérifie la connexion */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER BY Name"; if ($stmt = mysqli_prepare($link, $query)) { /* Exécute la requête */ mysqli_stmt_execute($stmt); /* Lie les variables de résultat */ mysqli_stmt_bind_result($stmt, $name, $code); /* Lit le résultat */ mysqli_stmt_store_result($stmt); /* Va à la ligne 400 */ mysqli_stmt_data_seek($stmt, 399); /* Lit une valeur */ mysqli_stmt_fetch($stmt); printf ("Ville : %s Pays: %s\n", $name, $code); /* Ferme la commande */ mysqli_stmt_close($stmt); } /* Ferme la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> Les exemples ci-dessus vont afficher : </para> <screen> <![CDATA[ Ville : Benin City Pays : NGA ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-execute.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-execute.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-execute.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-execute"> <refnamediv> <refname>mysqli_stmt_execute</refname> <refname>stmt->execute</refname> <refpurpose>Exécute une requête préparée</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_stmt_execute</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>mysql</classname></ooclass> <methodsynopsis> <type>bool</type> <methodname>execute</methodname> <methodparam><type>void</type><parameter></parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_execute</function> exécute une requête qui a été préalablement préparée en utilisant la fonction <function>mysqli_prepare</function>, grâce à la ressource <parameter>stmt</parameter>. Lors de l'exécution, toutes les variables de la requête seront remplacées par les données appropriées. </para> <para> Si la requête est UPDATE, DELETE ou INSERT, le nombre total de lignes affectées est disponible via la fonction <function>mysqli_stmt_affected_rows</function>. De la même façon, si la fonction génère un résultat, il sera disponible via la fonction <function>mysqli_fetch</function>. </para> <note> <para> Lors de l'utilisation de <function>mysqli_stmt_execute</function>, <function>mysqli_fetch</function> doit être utilisée pour lire les données avant de lancer une autre requête. </para> </note> </refsect1> <refsect1> <title>Valeurs retournées</title> <para>&return.success;</para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_prepare</function>, <function>mysqli_stmt_bind_param</function>. </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $mysqli->query("CREATE TABLE myCity LIKE City"); /* Préparation de la commande d'insertion */ $query = "INSERT INTO myCity (Name, CountryCode, District) VALUES (?,?,?)"; $stmt = $mysqli->prepare($query); $stmt->bind_param("sss", $val1, $val2, $val3); $val1 = 'Stuttgart'; $val2 = 'DEU'; $val3 = 'Baden-Wuerttemberg'; /* Exécution de la commande */ $stmt->execute(); $val1 = 'Bordeaux'; $val2 = 'FRA'; $val3 = 'Aquitaine'; /* Exécution de la commande */ $stmt->execute(); /* Fermeture de la commande */ $stmt->close(); /* Lit toutes les données de myCity */ $query = "SELECT Name, CountryCode, District FROM myCity"; if ($result = $mysqli->query($query)) { while ($row = $result->fetch_row()) { printf("%s (%s,%s)\n", $row[0], $row[1], $row[2]); } /* Libère de résultat */ $result->close(); } /* Suppression de la table */ $mysqli->query("DROP TABLE myCity"); /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } mysqli_query($link, "CREATE TABLE myCity LIKE City"); /* Préparation de la commande d'insertion */ $query = "INSERT INTO myCity (Name, CountryCode, District) VALUES (?,?,?)"; $stmt = mysqli_prepare($link, $query); mysqli_stmt_bind_param($stmt, "sss", $val1, $val2, $val3); $val1 = 'Stuttgart'; $val2 = 'DEU'; $val3 = 'Baden-Wuerttemberg'; /* Exécution de la commande */ mysqli_stmt_execute($stmt); $val1 = 'Bordeaux'; $val2 = 'FRA'; $val3 = 'Aquitaine'; /* Exécution de la commande */ mysqli_stmt_execute($stmt); /* Fermeture de la commande */ mysqli_stmt_close($stmt); /* Lit toutes les données de myCity */ $query = "SELECT Name, CountryCode, District FROM myCity"; if ($result = mysqli_query($link, $query)) { while ($row = mysqli_fetch_row($result)) { printf("%s (%s,%s)\n", $row[0], $row[1], $row[2]); } /* Libère de résultat */ mysqli_free_result($result); } /* Suppression de la table */ mysqli_query($link, "DROP TABLE myCity"); /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> Les exemples ci-dessus vont afficher : </para> <screen> <![CDATA[ Stuttgart (DEU,Baden-Wuerttemberg) Bordeaux (FRA,Aquitaine) ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-fetch.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-fetch.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-fetch.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-fetch"> <refnamediv> <refname>mysqli_stmt_fetch</refname> <refname>stmt->fetch</refname> <refpurpose> Lit des résultats depuis une requête MySQL préparée dans des variables liées </refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>mixed</type><methodname>mysqli_stmt_fetch</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>mixed</type> <methodname>fetch</methodname> <methodparam><type>void</type><parameter></parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_fetch</function> retourne une ligne de résultat, en utilisant les variables &php; liées par <function>mysqli_stmt_bind_result</function>. </para> <note> <para> Notez que toutes les colonnes doivent être liées à des variables &php; par l'application avant de pouvoir appeler <function>mysqli_stmt_fetch</function>. </para> </note> </refsect1> <refsect1> <title>Valeurs retournées</title> <table> <title>Valeurs retournées</title> <tgroup cols='2'> <thead> <row> <entry>Valeur</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry>&true;</entry> <entry>Réussite. Les données ont été lues.</entry> </row> <row> <entry>&false;</entry> <entry>Une erreur est survenue.</entry> </row> <row> <entry><literal>&null;</literal></entry> <entry>Il n'y a plus de ligne à lire</entry> </row> </tbody> </tgroup> </table> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_prepare</function>, <function>mysqli_stmt_errno</function>, <function>mysqli_stmt_error</function> et <function>mysqli_stmt_bind_result</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Object oriented style</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérifie la connection */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 150,5"; if ($stmt = $mysqli->prepare($query)) { /* Execution de la requête */ $stmt->execute(); /* Association des variables de résultat */ $stmt->bind_result($name, $code); /* Lecture des valeurs */ while ($stmt->fetch()) { printf ("%s (%s)\n", $name, $code); } /* Fermeture de la commande */ $stmt->close(); } /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procedural style</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérifie la connection */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 150,5"; if ($stmt = mysqli_prepare($link, $query)) { /* execute statement */ mysqli_stmt_execute($stmt); /* Association des variables de résultat */ mysqli_stmt_bind_result($stmt, $name, $code); /* Lecture des valeurs */ while (mysqli_stmt_fetch($stmt)) { printf ("%s (%s)\n", $name, $code); } /* Fermeture de la commande */ mysqli_stmt_close($stmt); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> L'exemple ci-dessus va afficher : </para> <screen> <![CDATA[ Rockford (USA) Tallahassee (USA) Salinas (USA) Santa Clarita (USA) Springfield (USA) ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-free-result.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-free-result.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-free-result.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-free-result"> <refnamediv> <refname>mysqli_stmt_free_result</refname> <refname>stmt->free_result</refname> <refpurpose>Libère le résultat MySQL de la mémoire</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>void</type><methodname>mysqli_stmt_free_result</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>void</type> <methodname>free_result</methodname> <methodparam><type>void</type><parameter></parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_free_result</function> libère le résultat <parameter>stmt</parameter> de la mémoire. <parameter>stmt</parameter> a été obtenu de la fonction <function>mysqli_stmt_store_result</function>. </para> </refsect1> <refsect1> &reftitle.returnvalues; <para> Cette fonction ne retourne pas de valeur. </para> </refsect1> <refsect1> &reftitle.seealso; <para> <function>mysqli_stmt_store_result</function>. </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-init.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-init.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-init.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-init"> <refnamediv> <refname>mysqli_stmt-init</refname> <refname>mysqli->stmt->init</refname> <refpurpose> Initialise une commande MySQL </refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procdural</para> <methodsynopsis> <type>object</type><methodname>mysqli_stmt_init</methodname> <methodparam><type>object</type><parameter>link</parameter></methodparam> </methodsynopsis> <para>Orient objet</para> <classsynopsis> <ooclass><classname>mysqli</classname></ooclass> <methodsynopsis> <type>object</type> <methodname>stmt_init</methodname> <void/> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_init</function> alloue et initialise un objet de commande, utiliser avec <function>mysqli_stmt_prepare</function>. </para> <note> <para> Tous les appels ultrieurs aux fonctions mysqli_stmt_* choueront, si <function>mysqli_stmt_prepare</function> est appel. </para> </note> </refsect1> <refsect1> &reftitle.returnvalues; <para> Retourne un objet. </para> </refsect1> <refsect1> &reftitle.seealso; <para> <function>mysqli_stmt_prepare</function>. </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-num-rows.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-num-rows.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-num-rows.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-num-rows"> <refnamediv> <refname>mysqli_stmt_num_rows</refname> <refname>stmt->num_rows</refname> <refpurpose>Retourne le nombre de lignes d'un rsultat MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>mixed</type><methodname>mysqli_stmt_num_rows</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <fieldsynopsis><type>int</type><varname>num_rows</varname></fieldsynopsis> </classsynopsis> <para> <methodname>mysqli_stmt_num_rows</methodname> retourne le nombre de lignes dans le rsultat <parameter>stmt</parameter>. L'utilisation de la fonction <function>mysqli_stmt_num_rows</function> dpend de l'utilisation ou non de la fonction <function>mysqli_stmt_store_result</function> pour stocker le rsultat dans la ressource de commande. </para> <para> Si vous utilisez <function>mysqli_stmt_store_result</function>, <function>mysqli_stmt_num_rows</function> peut tre appel immdiatement. </para> </refsect1> <refsect1> <title>Valeurs retournes</title> <para> Un entier reprsentant le nombre de lignes dans le rsultat. </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_stmt_affected_rows</function>, <function>mysqli_prepare</function> et <function>mysqli_stmt_store_result</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orient objet</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vrifie la connection */ if (mysqli_connect_errno()) { printf("Connexion choue : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20"; if ($stmt = $mysqli->prepare($query)) { /* Execution de la requte */ $stmt->execute(); /* Stockage du rsultat */ $stmt->store_result(); printf("Nombre de lignes : %d.\n", $stmt->num_rows); /* Fermeture de la commande */ $stmt->close(); } /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procedural style</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vrifie la connection */ if (mysqli_connect_errno()) { printf("Connexion choue : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20"; if ($stmt = mysqli_prepare($link, $query)) { /* Execution de la requte */ mysqli_stmt_execute($stmt); /* Stockage du rsultat */ mysqli_stmt_store_result($stmt); printf("Nombre de lignes : %d.\n", $stmt->num_rows); /* Fermeture de la commande */ mysqli_stmt_close($stmt); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> L'exemple ci-dessus va afficher : </para> <screen> <![CDATA[ Nombre de lignes : 20. ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-param-count.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-param-count.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-param-count.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-param-count"> <refnamediv> <refname>mysqli_stmt_param_count</refname> <refname>stmt->param_count</refname> <refpurpose>Retourne le nombre de paramètre d'une commande MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>int</type><methodname>mysqli_stmt_param_count</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <fieldsynopsis><type>int</type><varname>param_count</varname></fieldsynopsis> </classsynopsis> <para> <function>mysqli_stmt_param_count</function> retourne le nombre de variables attendues dans la requête préparée <parameter>stmt</parameter>. </para> </refsect1> <refsect1> &reftitle.returnvalues; <para> Retourne un entier représentant le nombre de paramètres. </para> </refsect1> <refsect1> &reftitle.seealso; <para> <function>mysqli_prepare</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } if ($stmt = $mysqli->prepare("SELECT Name FROM Country WHERE Name=? OR Code=?")) { $marker = $stmt->param_count; printf("La requête a %d variables.\n", $marker); /* Fermeture de la requête */ $stmt->close(); } /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } if ($stmt = mysqli_prepare($link, "SELECT Name FROM Country WHERE Name=? OR Code=?")) { $marker = mysqli_stmt_param_count($stmt); printf("La requête a %d variables.\n", $marker); /* Fermeture de la requête */ mysqli_stmt_close($stmt); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> Les exemples ci-dessus vont afficher : </para> <screen> <![CDATA[ La requête a 2 variables. ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-prepare.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-prepare.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-prepare.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-prepare"> <refnamediv> <refname>mysqli_stmt_prepare</refname> <refname>stmt->prepare</refname> <refpurpose> Prépare une requête SQL pour l'exécution </refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_stmt_prepare</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>mixed</type> <methodname>prepare</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_prepare</function> prépare la requête SQL <parameter>query</parameter>, pour la session de travail <parameter>stmt</parameter>. <parameter>stmt</parameter> doit avoir été alloué par <function>mysqli_stmt_init</function>. La requête doit être une seule requête SQL. </para> <note> <para> Il ne faut pas ajouter de point-virgule ou de <literal>\g</literal> à la fin de la requête. </para> </note> <para> Le paramètre <parameter>query</parameter> peut inclure une ou plusieurs variables SQL, en utilisant des points d'interrogation (<literal>?</literal>) aux bons endroits. </para> <note> <para> Les variables SQL ne sont possibles que dans certaines clauses de la requête SQL. Par exemple, elles peuvent être placées dans des clause VALUES() d'une requête INSERT (pour spécifier une valeur à insérer), ou dans une clause de condition WHERE. </para> <para> Cependant, elles ne sont pas autorisées pour les identifiants (de tables ou de colonnes), dans les listes de colonnes d'un SELECT, ou pour spécifier des opérateurs comme <literal>=</literal>. Cette dernière restriction est liée au fait qu'il est impossible de déterminer le type. En général, les variables SQL ne sont valides que dans les commandes de manipulations de données (Data Manipulation Languange (DML)), et non dans les structures du langages SQL (Data Defination Language (DDL)). </para> </note> <para> Les variables SQL doivent être associées à une variable &php; à l'aide de la fonction <function>mysqli_stmt_bind_param</function> et/ou <function>mysqli_stmt_bind_result</function>, avant d'exécuter la requête. </para> </refsect1> <refsect1> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1> &reftitle.seealso; <para> <function>mysqli_stmt_init</function>, <function>mysqli_stmt_execute</function>, <function>mysqli_stmt_fetch</function>, <function>mysqli_stmt_bind_param</function>, <function>mysqli_stmt_bind_result</function> et <function>mysqli_stmt_close</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } $city = "Amersfoort"; /* Création d'une requête préparée */ $stmt = $mysqli->stmt_init(); if ($stmt->prepare("SELECT District FROM City WHERE Name=?")) { /* Association des variables SQL */ $stmt->bind_param("s", $city); /* Exécution de la requête */ $stmt->execute(); /* Association des variables de résultats */ $stmt->bind_result($district); /* Lecture des valeurs */ $stmt->fetch(); printf("%s est dans le district de %s\n", $city, $district); /* Fermeture de la commande */ $stmt->close(); } /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } $city = "Amersfoort"; /* Création d'une requête préparée */ $stmt = mysqli_stmt_init(); if ($stmt = mysqli_stmt_prepare($stmt, "SELECT District FROM City WHERE Name=?")) { /* Association des variables SQL */ mysqli_stmt_bind_param($stmt, "s", $city); /* Exécution de la requête */ mysqli_stmt_execute($stmt); /* Association des variables de résultats */ mysqli_stmt_bind_result($stmt, $district); /* Lecture des valeurs */ mysqli_stmt_fetch($stmt); printf("%s est dans le district de %s\n", $city, $district); /* Fermeture de la commande */ mysqli_stmt_close($stmt); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> L'exemple ci-dessus va afficher : </para> <screen> <![CDATA[ Amersfoort est dans le district de Utrecht ]]> </screen> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-result-metadata.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-result-metadata.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-result-metadata.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-result-metadata"> <refnamediv> <refname>mysqli_stmt_result_metadata</refname> <refpurpose>Retourne les mta-donnes de prparation de requte MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procdural</para> <methodsynopsis> <type>mixed</type><methodname>mysqli_stmt_result_metadata</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <para>Orient objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>mixed</type> <methodname>result_metadata</methodname> <methodparam><type>void</type><parameter></parameter></methodparam> </methodsynopsis> </classsynopsis> <para> Si une commande a t prpare par <function>mysqli_prepare</function>, et qu'elle produira un rsultat, <function>mysqli_stmt_result_metadata</function> retourne l'objet de rsultat qui sera utilis pour lire les mta-donnes, comme le nombre de champs et les informations de colonnes. </para> <note> <para> Ce rsultat peut tre pass comme argument toute les fonctions qui demandent un champ, pour y lire les mta-donnes : <itemizedlist> <listitem><para><function>mysqli_num_fields</function></para></listitem> <listitem><para><function>mysqli_fetch_field</function></para></listitem> <listitem><para><function>mysqli_fetch_field_direct</function></para></listitem> <listitem><para><function>mysqli_fetch_fields</function></para></listitem> <listitem><para><function>mysqli_field_count</function></para></listitem> <listitem><para><function>mysqli_field_seek</function></para></listitem> <listitem><para><function>mysqli_field_tell</function></para></listitem> <listitem><para><function>mysqli_free_result</function></para></listitem> </itemizedlist> </para> </note> <para> Il est recommand de librer la ressource de rsultat lorsque vous avez termin de l'utilis, en la passant la fonction <function>mysqli_free_result</function> </para> <note> <para> Le jeu de rsultat retourn par <function>mysqli_stmt_result_metadata</function> ne contient que des mta-donnes. Il ne contient aucune ligne de rsultat. Ces lignes sont obtenues en utilisant la fonction <function>mysqli_fetch</function>. </para> </note> </refsect1> <refsect1> &reftitle.returnvalues; <para> <function>mysqli_stmt_result_metadata</function> retourne un objet de rsultat, ou &false; si une erreur survient. </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_prepare</function> et <function>mysqli_free_result</function> </para> </refsect1> <refsect1> <title>Exemple</title> <para> <example> <title>Orient objet</title> <programlisting role='php'> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "test"); $mysqli->query("DROP TABLE IF EXISTS friends"); $mysqli->query("CREATE TABLE friends (id int, name varchar(20))"); $mysqli->query("INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')"); $stmt = $mysqli->prepare("SELECT id, name FROM friends"); $stmt->execute(); /* Lit les mta-donnes de rsultat */ $result = $stmt->result_metadata(); /* Lit les informations d'un champ, depuis les mta-donnes */ $field = $result->fetch_field(); printf("Nom du champ : %s\n", $field->name); /* Libration du rsultat */ $result->close(); /* Fermeture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procdural</title> <programlisting role='php'> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "test"); mysqli_query($link, "DROP TABLE IF EXISTS friends"); mysqli_query($link, "CREATE TABLE friends (id int, name varchar(20))"); mysqli_query($link, "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')"); $stmt = mysqli_prepare($link, "SELECT id, name FROM friends"); mysqli_stmt_execute($stmt); /* Lit les mta-donnes de rsultat */ $result = mysqli_stmt_result_metadata($stmt); /* Lit les informations d'un champ, depuis les mta-donnes */ $field = mysqli_fetch_field($result); printf("Nom du champ : %s\n", $field->name); /* Libration du rsultat */ mysqli_free_result($result); /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-send-long-data.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-send-long-data.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-send-long-data.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-send-long-data"> <refnamediv> <refname>mysqli_stmt_send_long_data</refname> <refname>stmt->send_long_data</refname> <refpurpose>Envoie des données MySQL par paquet</refpurpose> </refnamediv> <refsect1> <title>Description</title> <para>Procédural</para> <methodsynopsis> <type>bool</type><methodname>mysqli_stmt_send_long_data</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> <methodparam><type>int</type><parameter>param_nr</parameter></methodparam> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> <para>Orienté objet</para> <classsynopsis> <ooclass><classname>stmt</classname></ooclass> <methodsynopsis> <type>bool</type><methodname>stmt_send_long_data</methodname> <methodparam><type>int</type><parameter>param_nr</parameter></methodparam> <methodparam><type>string</type><parameter>data</parameter></methodparam> </methodsynopsis> </classsynopsis> <para> <function>mysqli_stmt_send_long_data</function> envoie les données au serveur par paquets, si la taille des données excède la limite de <literal>max_allowed_packet</literal>. Cette fonctoin peut être appelée plusieurs fois pour envoyer les données textes ou binaires de champs comme les BLOB ou TEXT. </para> <para> <parameter>param_nr</parameter> indique quel paramètre doit être associé avec quelles données. Les paramètres sont numérotés à partir de 0. <parameter>data</parameter> est une chaîne de caractères, contenant les données à envoyer. </para> </refsect1> <refsect1> <title>Valeurs retournées</title> <para>&return.success;</para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_prepare</function>, <function>mysqli_stmt_bind_param</function> </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/co.php/phpdoc-fr/reference/mysqli/functions/mysqli-stmt-sqlstate.xml?r=1.1&p=1 Index: phpdoc-fr/reference/mysqli/functions/mysqli-stmt-sqlstate.xml +++ phpdoc-fr/reference/mysqli/functions/mysqli-stmt-sqlstate.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.mysqli-stmt-sqlstate"> <refnamediv> <refname>mysqli_stmt_sqlstate</refname> <refpurpose>Retourne le code SQLSTATE de la dernière opération MySQL</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>mysqli_stmt_sqlstate</methodname> <methodparam><type>object</type><parameter>stmt</parameter></methodparam> </methodsynopsis> <para> <function>mysqli_stmt_sqlstate</function> retourne une chaîne contenant le code d'erreur SQLSTATE de la commande la plus récente qui a été préparée. Le code d'erreur est constitué de 5 caractères. <literal>'00000'</literal> Les valeurs des codes d'erreurs sont spécifiées par les normes ANSI SQL et ODBC. Pour la liste complète des valeurs, voyez le fichier <ulink url="&url.mysql.docs.error;">&url.mysql.docs.error;</ulink>. </para> <note> <para> Notez que toutes les erreurs MySQL n'ont pas encore de correspondance en SQLSTATE. La valeur <literal>HY000</literal> (erreur générale) est utilisée pour les erreurs sans correspondance. </para> </note> </refsect1> <refsect1> <title>Valeurs retournées</title> <para> Retourne la chaîne contenant le code d'erreur SQLSTATE. Le code d'erreur est constitué de 5 caractères. <literal>'00000'</literal> représente l'absence d'erreur. </para> </refsect1> <refsect1> <title>Voir aussi</title> <para> <function>mysqli_stmt_errno</function> et <function>mysqli_stmt_error</function> </para> </refsect1> <refsect1> <title>Exemple</title> <example> <title>Orienté objet</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérifie la connection */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } $mysqli->query("CREATE TABLE myCountry LIKE Country"); $mysqli->query("INSERT INTO myCountry SELECT * FROM Country"); $query = "SELECT Name, Code FROM myCountry ORDER BY Name"; if ($stmt = $mysqli->prepare($query)) { /* Effacement de la table */ $mysqli->query("DROP TABLE myCountry"); /* Execution de la requête */ $stmt->execute(); printf("Erreur : %s.\n", $stmt->sqlstate); /* Fermeture de la commande */ $stmt->close(); } /* Fermture de la connexion */ $mysqli->close(); ?> ]]> </programlisting> </example> <example> <title>Procédural</title> <programlisting role="php"> <![CDATA[ <?php /* Ouvre la connexion */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérifie la connection */ if (mysqli_connect_errno()) { printf("Connexion échouée : %s\n", mysqli_connect_error()); exit(); } mysqli_query($link, "CREATE TABLE myCountry LIKE Country"); mysqli_query($link, "INSERT INTO myCountry SELECT * FROM Country"); $query = "SELECT Name, Code FROM myCountry ORDER BY Name"; if ($stmt = mysqli_prepare($link, $query)) { /* Effacement de la table */ mysqli_query($link, "DROP TABLE myCountry"); /* Execution de la requête */ mysqli_stmt_execute($stmt); printf("Erreur : %s.\n", mysqli_stmt_sqlstate($stmt)); /* Fermeture de la commande */ mysqli_stmt_close($stmt); } /* Fermeture de la connexion */ mysqli_close($link); ?> ]]> </programlisting> </example> <para> L'exemple ci-dessus va afficher : </para> <screen> <![CDATA[ Erreur : 42S02. ]]> </screen> </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 -->