com doc/fr: Apply commit 2bd21ff7be5615b10b5133fe896e0befd13df15c: reference/mysqli/mysqli_driver/report-mode.xml reference/ mysqli/summary.xml

Commit:    4ad86e5e0be3b28f6c351c830129a4e273e52ae7
Author:    George Peter Banyard <[email protected]>         Sun, 10 Jan 2021 20:13:48 +0000
Parents:   98eee30429d434f20b7a6e45c92a9c4634fc5e3a
Branches:  master

Link:       http://git.php.net/?p=doc/fr.git;a=commitdiff;h=4ad86e5e0be3b28f6c351c830129a4e273e52ae7

Log:
Apply commit 2bd21ff7be5615b10b5133fe896e0befd13df15c

Updating mysqli: fixing mysqli_report

Changed paths:
  M  reference/mysqli/mysqli_driver/report-mode.xml
  M  reference/mysqli/summary.xml


Diff:
diff --git a/reference/mysqli/mysqli_driver/report-mode.xml b/reference/mysqli/mysqli_driver/report-mode.xml
index 55d5d1e4e3..c8cbad2e2b 100644
--- a/reference/mysqli/mysqli_driver/report-mode.xml
+++ b/reference/mysqli/mysqli_driver/report-mode.xml
@@ -1,13 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 97986d5b11545e52b498c8d2f4cd88844d427390 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 2bd21ff7be5615b10b5133fe896e0befd13df15c Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
-
 <refentry xml:id="mysqli-driver.report-mode" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mysqli_driver::$report_mode</refname>
   <refname>mysqli_report</refname>
-  <refpurpose>Active ou désactive les fonctions de rapport interne</refpurpose>
+  <refpurpose>Définit le mode du rapport d'erreur mysqli</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -22,11 +21,14 @@
    <methodparam><type>int</type><parameter>flags</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Fonction utile pour améliorer les requêtes durant le développement du
-   code ainsi que lors des tests. Suivant les drapeaux fournis, elle
-   rapporte les erreurs depuis les appels aux fonctions MySQLi, ou
-   depuis les requêtes qui n'utilisent pas d'index (ou utilise un mauvais
-   index).
+   En fonction des drapeaux, ceci définit le mode du rapport d'erreur de mysqli
+   à exception, avertissement, ou aucun.
+   Quand définit à <constant>MYSQLI_REPORT_ALL</constant> ou <constant>MYSQLI_REPORT_INDEX</constant>
+   ceci va aussi informer à propos des requêtes qui n'utilisent pas d'index
+   (ou un mauvais index).
+  </para>
+  <para>
+   La valeur par défaut est <constant>MYSQLI_REPORT_OFF</constant>.
   </para>
  </refsect1>
 
@@ -85,7 +87,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   Retourne &true;.
   </para>
  </refsect1>
 
@@ -97,35 +99,22 @@
 <![CDATA[
 <?php
 
-$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
-
-/* Vérification de la connexion */
-if (mysqli_connect_errno()) {
-    printf("Echec de la connexion : %s\n", mysqli_connect_error());
-    exit();
-}
-
-/* Activation du reporting */
+/* Activation du rapport d'erreur */
 $driver = new mysqli_driver();
 $driver->report_mode = MYSQLI_REPORT_ALL;
 
 try {
+    /* si la connexion échoue, une mysqli_sql_exception sera lancé */
+    $mysqli = new mysqli("localhost", "my_user", "my_password", "my_db");
 
     /* cette requête devrait rapporter une erreur */
     $result = $mysqli->query("SELECT Name FROM Nonexistingtable WHERE population > 50000");
 
-    /* cette requête devrait rapporter un mauvais index */
+    /* cette requête devrait rapporter un mauvais index, si la colonne population n'a pas d'index */
     $result = $mysqli->query("SELECT Name FROM City WHERE population > 50000");
-
-    $result->close();
-
-    $mysqli->close();
-
 } catch (mysqli_sql_exception $e) {
-
-    echo $e->__toString();
+    error_log($e->__toString());
 }
-?>
 ]]>
    </programlisting>
   </example>
@@ -134,27 +123,46 @@ try {
    <programlisting role="php">
 <![CDATA[
 <?php
-/* Activation du reporting */
+
+/* Activation du rapport d'erreur */
 mysqli_report(MYSQLI_REPORT_ALL);
 
-$link = mysqli_connect("localhost", "my_user", "my_password", "world");
+try {
+    $link = mysqli_connect("localhost", "my_user", "my_password", "my_db");
 
-/* Vérification de la connexion */
-if (mysqli_connect_errno()) {
-    printf("Echec de la connexion : %s\n", mysqli_connect_error());
-    exit();
+    /* cette requête devrait rapporter une erreur */
+    $result = mysqli_query($link, "SELECT Name FROM Nonexistingtable WHERE population > 50000");
+
+    /* cette requête devrait rapporter un mauvais index, si la colonne population n'a pas d'index */
+    $result = mysqli_query($link, "SELECT Name FROM City WHERE population > 50000");
+} catch (mysqli_sql_exception $e) {
+    error_log($e->__toString());
 }
+]]>
+   </programlisting>
+  </example>
+  <example>
+   <title>Rapport d'erreur à l'exception des erreurs de mauvais index</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
 
-/* cette requête devrait rapporter une erreur */
-$result = mysqli_query("SELECT Name FROM Nonexistingtable WHERE population > 50000");
+/* Activation du rapport d'erreur */
+$driver = new mysqli_driver();
+$driver->report_mode = MYSQLI_REPORT_ALL;
 
-/* cette requête devrait rapporter un mauvais index */
-$result = mysqli_query("SELECT Name FROM City WHERE population > 50000");
+try {
+    /* si la connexion échoue, une mysqli_sql_exception sera lancé */
+    $mysqli = new mysqli("localhost", "my_user", "my_password", "my_db");
 
-mysqli_free_result($result);
+    /* cette requête devrait rapporter une erreur */
+    $result = $mysqli->query("SELECT Name FROM Nonexistingtable WHERE population > 50000");
 
-mysqli_close($link);
-?>
+    /* ceci n'émettra PAS d'erreur même si aucun index est disponible */
+    $result = $mysqli->query("SELECT Name FROM City WHERE population > 50000");
+} catch (mysqli_sql_exception $e) {
+    error_log($e->__toString());
+}
 ]]>
    </programlisting>
   </example>
@@ -164,8 +172,6 @@ mysqli_close($link);
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function>mysqli_debug</function></member>
-    <member><function>mysqli_dump_debug_info</function></member>
     <member><classname>mysqli_sql_exception</classname></member>
     <member><function>set_exception_handler</function></member>
     <member><function>error_reporting</function></member>
diff --git a/reference/mysqli/summary.xml b/reference/mysqli/summary.xml
index 3dee3e343d..b53216c0f5 100755
--- a/reference/mysqli/summary.xml
+++ b/reference/mysqli/summary.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: cea4f10f29c1e2ede3e5f42d0843195c17059362 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 2bd21ff7be5615b10b5133fe896e0befd13df15c Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes -->
 
 <chapter xml:id="mysqli.summary" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -674,7 +674,10 @@
      <entry><emphasis role="bold">&Properties;</emphasis></entry>
     </row>
     <row>
+     <entry><link linkend="mysqli-driver.report-mode">$mysqli_driver::mysqli_report</link></entry>
+     <entry><function>mysqli_report</function></entry>
      <entry>N/A</entry>
+     <entry>Définit le mode du rapport d'erreur de mysqli</entry>
     </row>
     <row>
      <entry><emphasis role="bold">&Methods;</emphasis></entry>