com doc/fr: Apply commit 383a659e1f0f7aa3330b31a095a1e927611d4c71: reference/mysqlinfo/concepts.xml reference/mysqlinfo/set.xml

[email protected] (George Peter Banyard) Wed, 13 Jan 2021 04:25:42 +0000
Newsgroups php.doc.fr
Message-ID <[email protected]>
Commit:    e092f7e4201ea06ecd5883a17ba695647bfd2cd8
Author:    George Peter Banyard <[email protected]>         Wed, 13 Jan 2021 04:25:13 +0000
Parents:   ad823568f6466b4fb458511b9b764005299753b8
Branches:  master

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

Log:
Apply commit 383a659e1f0f7aa3330b31a095a1e927611d4c71

Remove references to 'mysql' extension and to versions below 7.0

Changed paths:
  M  reference/mysqlinfo/concepts.xml
  M  reference/mysqlinfo/set.xml
diff_e092f7e4201ea06ecd5883a17ba695647bfd2cd8.txt (text/plain, 15 KB)
diff --git a/reference/mysqlinfo/concepts.xml b/reference/mysqlinfo/concepts.xml
index 3464b36450..519a65a555 100644
--- a/reference/mysqlinfo/concepts.xml
+++ b/reference/mysqlinfo/concepts.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: a714378ed87cdbdbde3b10ded183e8df7b243cb4 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 383a659e1f0f7aa3330b31a095a1e927611d4c71 Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
 <chapter xml:id="mysqlinfo.concepts" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Concepts</title>
@@ -82,7 +82,6 @@ if ($uresult) {
        echo $row['Name'] . PHP_EOL;
    }
 }
-$uresult->close();
 ?>
 ]]>
    </programlisting>
@@ -106,25 +105,6 @@ if ($uresult) {
 ]]>
    </programlisting>
   </example>
-
-  <example>
-   <title>Exemple de requêtes n'utilisant pas la mémoire tampon: mysql</title>
-   <programlisting role="php">
-<![CDATA[
-<?php
-$conn = mysql_connect("localhost", "my_user", "my_pass");
-$db   = mysql_select_db("world");
-
-$uresult = mysql_unbuffered_query("SELECT Name FROM City");
-if ($uresult) {
-   while ($row = mysql_fetch_assoc($uresult)) {
-       echo $row['Name'] . PHP_EOL;
-   }
-}
-?>
-]]>
-   </programlisting>
-  </example>
  </section>
 
  <section xml:id="mysqlinfo.concepts.charset">
@@ -145,8 +125,7 @@ if ($uresult) {
     Le jeu de caractères doit être compris et défini, sachant qu'il a un
     effet sur chaque action, et a des implications au niveau de la
     sécurité. Par exemple, le mécanisme d'échappement (i.e.
-    <function>mysqli_real_escape_string</function> pour mysqli,
-    <function>mysql_real_escape_string</function> pour mysql, et
+    <function>mysqli_real_escape_string</function> pour mysqli, et
     <methodname>PDO::quote</methodname> pour PDO_MySQL) va utiliser
     cette configuration. Il est important de garder en tête que ces fonctions
     n'utiliseront pas le jeu de caractères défini avec une requête, aussi,
@@ -173,7 +152,6 @@ $mysqli->set_charset('utf8mb4');
 
 // Mais, ceci NE l'affectera PAS (UTF-8 par rapport à utf8mb4) -- n'utilisez pas les tirets ici
 $mysqli->set_charset('UTF-8');
-
 ?>
 ]]>
    </programlisting>
@@ -201,16 +179,14 @@ $mysqli->set_charset('UTF-8');
 <?php
 $mysqli = new mysqli("localhost", "my_user", "my_password", "world");
 
-printf("Jeu de caractère initial : %s\n", $mysqli->character_set_name());
+echo 'Jeu de caractère initial : ' . $mysqli->character_set_name() . "\n";
 
 if (!$mysqli->set_charset('utf8mb4')) {
     printf("Erreur lors du chargement du jeu de caractères utf8mb4 : %s\n", $mysqli->error);
     exit;
 }
 
-echo "Nouvelle information du jeu de caractère :\n";
-print_r( $mysqli->get_charset() );
-
+echo 'Votre jeu de caractère actuel est : ' . $mysqli->character_set_name() . "\n";
 ?>
 ]]>
    </programlisting>
@@ -226,27 +202,6 @@ $pdo = new PDO("mysql:host=localhost;dbname=world;charset=utf8mb4", 'my_user', '
 ]]>
    </programlisting>
   </example>
-
-  <example>
-   <title>Exemple de définition du jeu de caractères : mysql</title>
-   <programlisting role="php">
-<![CDATA[
-<?php
-$conn = mysql_connect("localhost", "my_user", "my_pass");
-$db   = mysql_select_db("world");
-
-echo 'Jeu de caractère initial : ' .  mysql_client_encoding($conn) . "\n";
-
-if (!mysql_set_charset('utf8mb4', $conn)) {
-    echo "Erreur : Impossible de définir le jeu de caractères.\n";
-    exit;
-}
-
-echo 'Jeu de caractères courant : ' .  mysql_client_encoding($conn);
-?>
-]]>
-   </programlisting>
-  </example>  
  </section>
 
 </chapter>
diff --git a/reference/mysqlinfo/set.xml b/reference/mysqlinfo/set.xml
index 27cbce9b89..5d38d3bf5a 100644
--- a/reference/mysqlinfo/set.xml
+++ b/reference/mysqlinfo/set.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 98bf51d2b9db0a9acd1c9bcce8eecc5bcf60a63d Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 383a659e1f0f7aa3330b31a095a1e927611d4c71 Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
 
 <set xml:id="set.mysqlinfo">
@@ -27,12 +27,10 @@
    <title>Introduction</title>
    <abstract>
     <para>
-     En fonction de la version de PHP, il y a soit deux soit trois APIs PHP
-     pour accéder à une base de données MySQL. Les utilisateurs de PHP 5 peuvent
-     choisir entre l'extension obsolète <link linkend="book.mysql">mysql</link>,
-     <link linkend="book.mysqli">mysqli</link>, ou
-     <link linkend="ref.pdo-mysql">PDO_MySQL</link>. PHP 7 supprime l'extension
-     mysql, ne laissant que les deux dernières options.
+     Il y a plusieurs APIs PHP pour accéder à une base de données MySQL.
+     Les utilisateurs peuvent choisir entre les extensions
+     <link linkend="book.mysqli">mysqli</link> ou
+     <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
     </para>
     <para>
      Ce guide explique la <link linkend="mysqlinfo.terminology">terminologie</link>
@@ -144,8 +142,7 @@
     d'un coeur, avec des extensions optionnelles permettant
     d'étendre les fonctionnalités du coeur. Les extensions PHP relatives
     aux bases de données, comme l'extension <literal>mysqli</literal>
-    et l'extension <literal>mysql</literal> sont implémentées
-    en utilisant le framework des extensions PHP.
+    qui est implémentée en utilisant le framework des extensions PHP.
    </para>
 
    <para>
@@ -170,15 +167,15 @@
   <chapter xml:id="mysqlinfo.api.choosing" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
    <title>Choisir une API</title>
    <para>
-    PHP offre 3 APIs différentes pour se connecter à MySQL. Ci-dessous, vous
-    trouverez les APIs fournies par les extensions mysql, mysqli et PDO.
+    PHP offre des APIs différentes pour se connecter à MySQL. Ci-dessous, vous
+    trouverez les APIs fournies par les extensions mysqli et PDO.
     Chaque exemple de code crée une connexion à un serveur MySQL s'exécutant sur
     le domaine "example.com", en utilisant le nom d'utilisateur "user", le mot
     de passe "password". Et une requête est exécutée pour saluer l'utilisateur.
    </para>
    <para>
     <example>
-     <title>Comparaison des 3 APIs MySQL</title>
+     <title>Comparaison des APIs MySQL</title>
      <programlisting role="php">
 <![CDATA[
 <?php
@@ -193,44 +190,26 @@ $pdo = new PDO('mysql:host=example.com;dbname=database', 'user', 'password');
 $statement = $pdo->query("SELECT 'Bonjour, cher utilisateur de MySQL !' AS _message FROM DUAL");
 $row = $statement->fetch(PDO::FETCH_ASSOC);
 echo htmlentities($row['_message']);
-
-// mysql
-$c = mysql_connect("example.com", "user", "password");
-mysql_select_db("database");
-$result = mysql_query("SELECT 'Bonjour, cher utilisateur de MySQL !' AS _message FROM DUAL");
-$row = mysql_fetch_assoc($result);
-echo htmlentities($row['_message']);
-?>
 ]]>
      </programlisting>
     </example>
    </para>
    <para>
-    <emphasis role="bold">API recommandé</emphasis>
+    <emphasis role="bold">Comparaison des fonctionnalités</emphasis>
    </para>
    <para>
-    Il est recommandé d'utiliser soit l'extension <link linkend="book.mysqli">mysqli</link>,
-    soit l'extension <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
-    Il n'est pas recommandé d'utiliser l'ancienne extension
-    <link linkend="ref.mysql">mysql</link> pour de nouveaux développements sachant qu'elle
-    est obsolète depuis PHP 5.5.0, et a été supprimée en PHP 7.
-    Une matrice de comparaison détaillant les fonctionnalités est fournie ci-dessous.
-    La performance globale des 3 extensions peut être considérée comme identique.
+    La performance globale des deux extensions peut être considérée comme identique.
     Malgré tout, la performance de l'extension constitue seulement une fraction
     du temps total d'exécution d'une requête web PHP.
     Souvent, l'impact est inférieur à 0.1%.
    </para>
-   <para>
-    <emphasis role="bold">Comparaison des fonctionnalités</emphasis>
-   </para>
    <informaltable>
-    <tgroup cols="4">
+    <tgroup cols="3">
      <thead>
       <row>
        <entry></entry>
        <entry>ext/mysqli</entry>
        <entry>PDO_MySQL</entry>
-       <entry>ext/mysql</entry>
       </row>
      </thead>
      <tbody>
@@ -238,59 +217,44 @@ echo htmlentities($row['_message']);
        <entry>Introduite en PHP version</entry>
        <entry>5.0</entry>
        <entry>5.1</entry>
-       <entry>2.0</entry>
       </row>
       <row>
-       <entry>Inclus avec PHP 5.x</entry>
-       <entry>Oui</entry>
+       <entry>Inclus avec PHP 7.x et 8.x</entry>
        <entry>Oui</entry>
        <entry>Oui</entry>
       </row>
       <row>
-       <entry>Inclus avec PHP 7.x</entry>
-       <entry>Yes</entry>
-       <entry>Yes</entry>
-       <entry>No</entry>
-      </row>
-      <row>
        <entry>Statut du développement</entry>
        <entry>Active</entry>
        <entry>Active</entry>
-       <entry>Uniquement en maintenance en 5.x ; supprimée en 7.x</entry>
       </row>
       <row>
        <entry>Cycle de vie</entry>
        <entry>Active</entry>
        <entry>Active</entry>
-       <entry>Obsolète en 5.x ; supprimée en 7.x</entry>
       </row>
       <row>
        <entry>Recommandé pour de nouveaux projets</entry>
        <entry>Oui</entry>
        <entry>Oui</entry>
-       <entry>Non</entry>
       </row>
       <row>
        <entry>Interface orientée objet</entry>
        <entry>Oui</entry>
        <entry>Oui</entry>
-       <entry>Non</entry>
       </row>
       <row>
        <entry>Interface procédurale</entry>
        <entry>Oui</entry>
        <entry>Non</entry>
-       <entry>Oui</entry>
       </row>
       <row>
        <entry>L'API supporte les requêtes non-bloquantes, asynchrones avec mysqlnd</entry>
        <entry>Oui</entry>
        <entry>Non</entry>
-       <entry>Non</entry>
       </row>
       <row>
-       <entry>Connexions persistentes disponibles</entry>
-       <entry>Oui</entry>
+       <entry>Connexions persistantes disponibles</entry>
        <entry>Oui</entry>
        <entry>Oui</entry>
       </row>
@@ -298,49 +262,41 @@ echo htmlentities($row['_message']);
        <entry>L'API supporte les jeux de caractères</entry>
        <entry>Oui</entry>
        <entry>Oui</entry>
-       <entry>Oui</entry>
       </row>
       <row>
        <entry>L'API supporte les requêtes préparées côté serveur</entry>
        <entry>Oui</entry>
        <entry>Oui</entry>
-       <entry>Non</entry>
       </row>
       <row>
        <entry>L'API supporte les requêtes préparées côté client</entry>
        <entry>Non</entry>
        <entry>Oui</entry>
-       <entry>Non</entry>
       </row>
       <row>
        <entry>L'API supporte les procédures stockées</entry>
        <entry>Oui</entry>
        <entry>Oui</entry>
-       <entry>Non</entry>
       </row>
       <row>
        <entry>L'API supporte les requêtes multiples</entry>
        <entry>Oui</entry>
        <entry>La plupart</entry>
-       <entry>Non</entry>
       </row>
       <row>
        <entry>L'API supporte les transactions</entry>
        <entry>Oui</entry>
        <entry>Oui</entry>
-       <entry>Non</entry>
       </row>
       <row>
        <entry>Les transactions peuvent être contrôlées avec SQL</entry>
        <entry>Oui</entry>
        <entry>Oui</entry>
-       <entry>Oui</entry>
       </row>
       <row>
        <entry>Supporte toutes les fonctionnalités de MySQL 5.1+</entry>
        <entry>Oui</entry>
        <entry>La plupart</entry>
-       <entry>Non</entry>
       </row>
      </tbody>
     </tgroup>
@@ -350,14 +306,14 @@ echo htmlentities($row['_message']);
   <chapter xml:id="mysqlinfo.library.choosing" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
    <title>Choisir une bibliothèque</title>
    <para>
-    Les extensions mysqli, PDO_MySQL et mysql sont des wrappers légers d'une
+    Les extensions PHP mysqli et PDO_MySQL sont des wrappers légers d'une
     bibliothèque cliente C. Les extensions peuvent soit utiliser la bibliothèque
     <link linkend="book.mysqlnd">mysqlnd</link>, soit la bibliothèque <literal>libmysqlclient</literal>.
     Le choix de la bibliothèque se fait au moment de la compilation.
    </para>
    <para>
-    La bibliothèque mysqlnd fait partie de la distribution de PHP depuis la version
-    5.3.0. Elle offre des fonctionnalités comme les connexions paresseuses,
+    La bibliothèque mysqlnd fait partie de la distribution de PHP.
+    Elle offre des fonctionnalités comme les connexions paresseuses,
     la mise en cache de requêtes, qui ne sont pas disponibles avec libmysqlclient,
     aussi, nous vous recommandons d'utiliser la bibliothèque interne mysqlnd.
     Voir la <link linkend="book.mysqlnd">documentation de mysqlnd</link>
@@ -369,13 +325,13 @@ echo htmlentities($row['_message']);
      <programlisting role="shell">
 <![CDATA[
 // Recommandé, compilation avec mysqlnd
-$ ./configure --with-mysqli=mysqlnd --with-pdo-mysql=mysqlnd --with-mysql=mysqlnd
+$ ./configure --with-mysqli=mysqlnd --with-pdo-mysql=mysqlnd
 
-// Alternativement recommandé, compilation avec mysqlnd à partir de PHP 5.4
-$ ./configure --with-mysqli --with-pdo-mysql --with-mysql
+// Alternativement recommandé, compilation avec mysqlnd
+$ ./configure --with-mysqli --with-pdo-mysql
 
 // Non recommandé, compilation avec libmysqlclient
-$ ./configure --with-mysqli=/path/to/mysql_config --with-pdo-mysql=/path/to/mysql_config --with-mysql=/path/to/mysql_config
+$ ./configure --with-mysqli=/path/to/mysql_config --with-pdo-mysql=/path/to/mysql_config
 ]]>
      </programlisting>
     </example>
@@ -424,28 +380,23 @@ $ ./configure --with-mysqli=/path/to/mysql_config --with-pdo-mysql=/path/to/mysq
        <entry>Pas de fin d'annoncé</entry>
       </row>
       <row>
-       <entry>Compilé par défaut en PHP 5.4 et ultérieur (pour toutes les extensions MySQL)</entry>
+       <entry>Compilé par défaut (pour toutes les extensions MySQL)</entry>
        <entry>Oui</entry>
        <entry>Non</entry>
       </row>
       <row>
-       <entry>Compilé par défaut en PHP 5.3 (pour toutes les extensions MySQL)</entry>
-       <entry>Non</entry>
-       <entry>Oui</entry>
-      </row>
-      <row>
        <entry>Support du protocole de compression</entry>
-       <entry>Oui (5.3.1+)</entry>
+       <entry>Oui</entry>
        <entry>Oui</entry>
       </row>
       <row>
        <entry>Support de SSL</entry>
-       <entry>Oui (5.3.3+)</entry>
+       <entry>Oui</entry>
        <entry>Oui</entry>
       </row>
       <row>
        <entry>Support des pipes nommés</entry>
-       <entry>Oui (5.3.4+)</entry>
+       <entry>Oui</entry>
        <entry>Oui</entry>
       </row>
       <row>
@@ -485,7 +436,7 @@ $ ./configure --with-mysqli=/path/to/mysql_config --with-pdo-mysql=/path/to/mysq
        <entry>Limité</entry>
       </row>
       <row>
-       <entry>Séparation des lectures et des écritues pour la réplication MySQL</entry>
+       <entry>Séparation des lectures et des écritures pour la réplication MySQL</entry>
        <entry>Oui, avec un plugin</entry>
        <entry>Non</entry>
       </row>