[Sync-En] pdo: revert constant types to int, document getAttribute() bool change

reference/pdo/constants.xml

@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 00b118595a963f00211e96224e3fba35bdebc83c Maintainer: lacatoire Status: ready -->
 <appendix xml:id="pdo.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &extension.constants;
 
  &reference.pdo.constants.fetch-modes;
 
  <section xml:id="pdo.constants.cursors" annotations="chunk:false">
-  <title>Curseur</title>
+  <title>Curseurs</title>
 
   <simpara>
    Voir aussi <constant>PDO::ATTR_CURSOR_NAME</constant>.
@@ -113,7 +113,7 @@
  </section>
 
  <section annotations="chunk:false">
-  <title>Autre constante</title>
+  <title>Autres constantes</title>
   <variablelist>
    <varlistentry xml:id="pdo.constants.param-bool">
     <term>
@@ -225,17 +225,13 @@
    <varlistentry xml:id="pdo.constants.attr-autocommit">
     <term>
      <constant>PDO::ATTR_AUTOCOMMIT</constant>
-     (<type>bool</type>)
+     (<type>int</type>)
     </term>
     <listitem>
      <simpara>
       Si cette valeur est &false;, PDO tente de désactiver l'autocommit afin que la
       connexion commence une transaction.
      </simpara>
-     <simpara>
-      À partir de PHP 8.4.0, cette constante est de type <type>bool</type> ;
-      elle était auparavant de type <type>int</type>.
-     </simpara>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo.constants.attr-prefetch">
@@ -245,7 +241,7 @@
     </term>
     <listitem>
      <simpara>
-      Définit la taille de prélecture permet de trouver un équilibre entre la vitesse et l'utilisation
+      Définir la taille de prélecture permet de trouver un équilibre entre la vitesse et l'utilisation
       de la mémoire pour l'application. Toutes les combinaisons de bases de données/pilotes ne prennent pas
       en charge la définition de la taille de prélecture. Une taille de prélecture plus grande entraîne une
       augmentation des performances au prix d'une utilisation de la mémoire plus élevée.
@@ -313,8 +309,8 @@
     </term>
     <listitem>
      <simpara>
-      Cette valeur est en lecture seule ; elle renverra des informations sur la
-      version du serveur de base de données auquel PDO est connecté.
+      Cette valeur est en lecture seule ; elle renverra des méta-informations
+      sur le serveur de base de données auquel PDO est connecté.
      </simpara>
     </listitem>
    </varlistentry>
@@ -411,7 +407,7 @@
     <listitem>
      <simpara>
       Demande une connexion persistante, plutôt que de créer une nouvelle connexion.
-      Voir <link linkend="pdo.connections">connections et gestion
+      Voir <link linkend="pdo.connections">Connexions et gestion
       des connexions</link> pour plus d'informations sur cet attribut.
      </simpara>
     </listitem>
@@ -496,7 +492,7 @@
    <varlistentry xml:id="pdo.constants.attr-emulate-prepares">
     <term>
      <constant>PDO::ATTR_EMULATE_PREPARES</constant>
-     (<type>bool</type>)
+     (<type>int</type>)
     </term>
     <listitem>
      <simpara>
@@ -506,10 +502,6 @@
       requêtes préparées ; lorsqu'elle vaut &false;, il utilise les requêtes
       préparées natives du pilote.
      </simpara>
-     <simpara>
-      À partir de PHP 8.4.0, cette constante est de type <type>bool</type> ;
-      elle était auparavant de type <type>int</type>.
-     </simpara>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo.constants.attr-default-str-param">
@@ -537,8 +529,8 @@
      <simpara>
       Ne pas lever d'erreur ou d'exception si une erreur se produit.
       Le développeur est censé vérifier explicitement les erreurs.
-      Avant PHP 8.0.0, ceci est le mode par défaut.
-      Voir <link linkend="pdo.error-handling">erreur et gestion des erreurs</link>
+      Avant PHP 8.0.0, ceci était le mode par défaut.
+      Voir <link linkend="pdo.error-handling">Erreurs et gestion des erreurs</link>
       pour plus d'informations sur cet attribut.
      </simpara>
     </listitem>
@@ -551,7 +543,7 @@
     <listitem>
      <simpara>
       Émet un message PHP <constant>E_WARNING</constant> si une erreur se produit.
-      Voir <link linkend="pdo.error-handling">erreur et gestion des erreurs</link>
+      Voir <link linkend="pdo.error-handling">Erreurs et gestion des erreurs</link>
       pour plus d'informations sur cet attribut.
      </simpara>
     </listitem>
@@ -565,7 +557,7 @@
      <simpara>
       Lève une <classname>PDOException</classname> si une erreur se produit.
       Ceci est le mode par défaut à partir de PHP 8.0.0.
-      Voir <link linkend="pdo.error-handling">erreur et gestion des erreurs</link>
+      Voir <link linkend="pdo.error-handling">Erreurs et gestion des erreurs</link>
       pour plus d'informations sur cet attribut.
      </simpara>
     </listitem>
@@ -745,7 +737,7 @@
      </warning>
      <simpara>
        Spécifie qu'une fonction créée avec <methodname>PDO::sqliteCreateFunction</methodname>
-       est déterministe, c'est-à-dire qu'elle renvoie toujours le même résultat donné les mêmes entrées dans
+       est déterministe, c'est-à-dire qu'elle renvoie toujours le même résultat pour les mêmes entrées dans
        une seule instruction SQL. (Disponible à partir de PHP 7.1.4.)
      </simpara>
     </listitem>

reference/pdo/pdo/getattribute.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9c73659a3578fa34561e7e6531f98c4eaac4c990 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 00b118595a963f00211e96224e3fba35bdebc83c Maintainer: lacatoire Status: ready -->
 <refentry xml:id="pdo.getattribute" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>PDO::getAttribute</refname>
@@ -21,8 +21,8 @@
   </para>
 
   <para>
-   Il est à noter que quelques bases de données/drivers combinés ne supportent pas tous les attributs
-   de connexion.
+   Il est à noter que certaines combinaisons base de données/pilote ne prennent pas en charge tous les
+   attributs de connexion.
   </para>
 
  </refsect1>
@@ -93,6 +93,17 @@
        <constant>PDO::ATTR_STRINGIFY_FETCHES</constant>.
       </entry>
      </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       La valeur de <constant>PDO::ATTR_AUTOCOMMIT</constant> est désormais retournée
+       sous forme de <type>bool</type> par les pilotes MySQL et Firebird, et la valeur de
+       <constant>PDO::ATTR_EMULATE_PREPARES</constant> et de
+       <constant>PDO::MYSQL_ATTR_DIRECT_QUERY</constant> est désormais retournée sous forme de
+       <type>bool</type> par le pilote MySQL ; auparavant, elles étaient retournées sous forme
+       d'<type>int</type>.
+      </entry>
+     </row>
     </tbody>
    </tgroup>
   </informaltable>
@@ -108,14 +119,14 @@
 <?php
 $conn = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');
 $attributes = array(
-"AUTOCOMMIT", "ERRMODE", "CASE", "CLIENT_VERSION", "CONNECTION_STATUS",
-"ORACLE_NULLS", "PERSISTENT", "PREFETCH", "SERVER_INFO", "SERVER_VERSION",
-"TIMEOUT"
+    "AUTOCOMMIT", "ERRMODE", "CASE", "CLIENT_VERSION", "CONNECTION_STATUS",
+    "ORACLE_NULLS", "PERSISTENT", "PREFETCH", "SERVER_INFO", "SERVER_VERSION",
+    "TIMEOUT"
 );
 
 foreach ($attributes as $val) {
-   echo "PDO::ATTR_$val: ";
-   echo $conn->getAttribute(constant("PDO::ATTR_$val")) . "\n";
+    echo "PDO::ATTR_$val: ";
+    echo $conn->getAttribute(constant("PDO::ATTR_$val")) . "\n";
 }
 ?>
 ]]>

reference/pdo_dblib/pdo-dblib.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5d8e96f9b174f7471daebce760657eb0f190b0ba Maintainer: lacatoire Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 00b118595a963f00211e96224e3fba35bdebc83c Maintainer: lacatoire Status: ready -->
 <reference xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.pdo-dblib" role="class">
  <title>La classe Pdo\Dblib</title>
  <titleabbrev>Pdo\Dblib</titleabbrev>
@@ -34,9 +33,7 @@
      </ooclass>
 
      <classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
-     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
-      <xi:fallback/>
-     </xi:include>
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))"/>
 
      <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
      <fieldsynopsis>
@@ -54,7 +51,7 @@
      <fieldsynopsis>
       <modifier>public</modifier>
       <modifier>const</modifier>
-      <type>bool</type>
+      <type>int</type>
       <varname linkend="pdo-dblib.constants.attr-stringify-uniqueidentifier">Pdo\Dblib::ATTR_STRINGIFY_UNIQUEIDENTIFIER</varname>
      </fieldsynopsis>
      <fieldsynopsis>
@@ -78,17 +75,13 @@
      <fieldsynopsis>
       <modifier>public</modifier>
       <modifier>const</modifier>
-      <type>bool</type>
+      <type>int</type>
       <varname linkend="pdo-dblib.constants.attr-datetime-convert">Pdo\Dblib::ATTR_DATETIME_CONVERT</varname>
      </fieldsynopsis>
 
      <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
-     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='PDO'])">
-      <xi:fallback/>
-     </xi:include>
-     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='PDO'])">
-      <xi:fallback/>
-     </xi:include>
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='PDO'])"/>
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='PDO'])"/>
     </classsynopsis>
    </packagesynopsis>
    <!-- }}} -->
@@ -116,8 +109,6 @@
      <term><constant>Pdo\Dblib::ATTR_STRINGIFY_UNIQUEIDENTIFIER</constant></term>
      <listitem>
       <simpara>
-       À partir de PHP 8.4.0, cette constante est de type <type>bool</type> ;
-       elle était auparavant de type <type>int</type>.
       </simpara>
      </listitem>
     </varlistentry>
@@ -155,10 +146,6 @@
        le fichier FreeTDS <filename>locales.conf</filename>. Par défaut, cet
        attribut vaut &false;.
       </simpara>
-      <simpara>
-       À partir de PHP 8.4.0, cette constante est de type <type>bool</type> ;
-       elle était auparavant de type <type>int</type>.
-      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>

reference/pdo_mysql/constants.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8d40a1fab3f89d6e35caece522991b67fb9df246 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 00b118595a963f00211e96224e3fba35bdebc83c Maintainer: lacatoire Status: ready -->
 <!-- Reviewed: no -->
 <section xml:id="ref.pdo-mysql.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
@@ -93,16 +93,12 @@
   <varlistentry xml:id="pdo.constants.mysql-attr-direct-query">
    <term>
     <constant>PDO::MYSQL_ATTR_DIRECT_QUERY</constant>
-    (<type>bool</type>)
+    (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      &Alias; <constant>PDO::ATTR_EMULATE_PREPARES</constant>
     </simpara>
-    <simpara>
-     À partir de PHP 8.4.0, cette constante est de type <type>bool</type> ;
-     elle était auparavant de type <type>int</type>.
-    </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="pdo.constants.mysql-attr-found-rows">