[Sync-En] ext/pdo: PHP 8.4 changes across PDO, PDO_PGSQL and PDO_Firebird (#5703)

reference/pdo/pdo/getattribute.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 91183ddf1c54c6ce3051fdf0f5b9987272d51fbe Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="pdo.getattribute" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -39,18 +39,14 @@
        Una de las constantes <literal>PDO::ATTR_*</literal>. Los atributos genéricos
        que se aplican a las conexiones son los siguientes:
        <simplelist>
-        <member><literal>PDO::ATTR_AUTOCOMMIT</literal></member>
         <member><literal>PDO::ATTR_CASE</literal></member>
-        <member><literal>PDO::ATTR_CLIENT_VERSION</literal></member>
-        <member><literal>PDO::ATTR_CONNECTION_STATUS</literal></member>
+        <member><literal>PDO::ATTR_DEFAULT_FETCH_MODE</literal></member>
         <member><literal>PDO::ATTR_DRIVER_NAME</literal></member>
         <member><literal>PDO::ATTR_ERRMODE</literal></member>
         <member><literal>PDO::ATTR_ORACLE_NULLS</literal></member>
         <member><literal>PDO::ATTR_PERSISTENT</literal></member>
-        <member><literal>PDO::ATTR_PREFETCH</literal></member>
-        <member><literal>PDO::ATTR_SERVER_INFO</literal></member>
-        <member><literal>PDO::ATTR_SERVER_VERSION</literal></member>
-        <member><literal>PDO::ATTR_TIMEOUT</literal></member>
+        <member><literal>PDO::ATTR_STATEMENT_CLASS</literal></member>
+        <member><literal>PDO::ATTR_STRINGIFY_FETCHES</literal></member>
        </simplelist>
       </para>
       <simpara>

reference/pdo/pdo/prepare.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="pdo.prepare" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -61,12 +61,12 @@
   </para>
   <note>
    <simpara>
-    El analizador utilizado para las declaraciones preparadas
+    Antes de PHP 8.4.0, el analizador utilizado para las declaraciones preparadas
     emuladas y para reescribir los parámetros nombrados o del estilo de punto
-    de interrogación soporta el escape backslash no estándar para las comillas simples y dobles. Esto significa que las comillas finales que
-    son precedidas por un backslash no serán reconocidas como tales, lo que puede
+    de interrogación soportaba el escape backslash no estándar para las comillas simples y dobles. Esto significaba que las comillas finales que
+    eran precedidas por un backslash no serían reconocidas como tales, lo que podía
     resultar en una mala detección de los parámetros causando que la declaración
-    preparada falle al ser ejecutada. Un contorno es no utilizar las consultas emuladas para tales consultas SQL, y evitar reescribir los parámetros utilizando un estilo de parámetro que es
+    preparada fallase al ser ejecutada. Un contorno era no utilizar las consultas emuladas para tales consultas SQL, y evitar reescribir los parámetros utilizando un estilo de parámetro que era
     soportado nativamente por el controlador.
    </simpara>
   </note>
@@ -75,6 +75,15 @@
    Esto significa que la cadena <literal>??</literal> será traducida en <literal>?</literal>
    al enviar la consulta a la base de datos.
   </para>
+  <simpara>
+   A partir de PHP 8.4.0, PDO utiliza analizadores SQL específicos del controlador para
+   localizar los marcadores de parámetros, de modo que los marcadores que aparecen dentro
+   de literales de cadena o comentarios no se confunden con marcadores de posición. El analizador
+   por omisión reconoce los literales de cadena entre comillas simples y dobles, así como los
+   comentarios de dos guiones y de estilo C no anidados. Los controladores individuales pueden
+   proporcionar un analizador que reconozca sintaxis adicional o diferente; consulte la
+   documentación específica del controlador para más detalles.
+  </simpara>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;

reference/pdo/pdostatement/getattribute.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="pdostatement.getattribute" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -26,6 +26,13 @@
       Recupera el nombre del cursor para <literal>UPDATE ... WHERE CURRENT OF</literal>.
      </simpara>
     </listitem>
+    <listitem>
+     <simpara>
+      <constant>Pdo\Pgsql::ATTR_RESULT_MEMORY_SIZE</constant>
+      (específico de PostgreSQL, disponible desde PHP 8.4.0):
+      Recupera la cantidad de memoria, en bytes, asignada al resultado de la consulta.
+     </simpara>
+    </listitem>
    </itemizedlist>
    Tenga en cuenta que los atributos específicos del controlador <emphasis>no deben</emphasis>
    utilizarse con otros controladores.

reference/pdo_firebird/configure.xml

@@ -1,7 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: c316dd3b8bce869f1c92c760900a29c2ba0a71af Maintainer: seros Status: ready -->
-<!-- Reviewed: no -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: seros Status: ready -->
 <section xml:id="ref.pdo-firebird.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.install;
  <para>
@@ -14,6 +12,10 @@ $ ./configure --with-pdo-firebird
 ]]>
   </screen>
  </para>
+ <simpara>
+  A partir de PHP 8.4.0, esta extensión utiliza las API C++ de Firebird y por lo tanto
+  requiere un compilador C++, y debe compilarse con fbclient 3.0 o superior.
+ </simpara>
 </section>
 
 <!-- Keep this comment at the end of the file

reference/pdo_pgsql/configure.xml

@@ -1,7 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: c316dd3b8bce869f1c92c760900a29c2ba0a71af Maintainer: jvenegasperu Status: ready -->
-<!-- Reviewed: yes Maintainer: seros -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: jvenegasperu Status: ready -->
 <section xml:id="ref.pdo-pgsql.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.install;
  <para>
@@ -14,6 +12,10 @@ $ ./configure --with-pdo-pgsql
 ]]>
   </screen>
  </para>
+ <simpara>
+  Esta extensión requiere libpq (la biblioteca cliente C de PostgreSQL).
+  A partir de PHP 8.4.0, se requiere libpq 10.0 o posterior.
+ </simpara>
 </section>
 
 <!-- Keep this comment at the end of the file

reference/pdo_pgsql/pdo-pgsql.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 205c3b8ad9af665e2b49dcc6020005bb479217a3 Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: PhilDaiguille Status: ready -->
 <reference xml:id="class.pdo-pgsql" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" role="class">
  <title>La clase Pdo\Pgsql</title>
  <titleabbrev>Pdo\Pgsql</titleabbrev>
@@ -46,6 +45,14 @@
      </listitem>
     </itemizedlist>
    </para>
+   <note>
+    <simpara>
+     Dado que este analizador reconoce los literales de cadena en dólares, los puntos
+     de interrogación que aparecen en ellos no son tratados como marcadores de parámetros y
+     no necesitan ser escapados. A partir de PHP 8.4.0, escapar los puntos de interrogación
+     como <literal>??</literal> dentro de una cadena en dólares está obsoleto.
+    </simpara>
+   </note>
   </section>
   <!-- }}} -->
 

reference/pdo_pgsql/reference.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 858400b07586b88dcb1e17a95e7a178b54b89d86 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 <reference xml:id="ref.pdo-pgsql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <?phpdoc extension-membership="bundledexternal" ?>
@@ -122,6 +121,15 @@
 
      </variablelist>
 
+     <note>
+      <simpara>
+       A partir de PHP 8.4.0, las credenciales especificadas en el DSN
+       (<literal>user</literal> y <literal>password</literal>) tienen prioridad
+       sobre los argumentos correspondientes pasados al constructor de
+       <classname>PDO</classname>. En versiones anteriores, los argumentos del
+       constructor PDO tenían precedencia.
+      </simpara>
+     </note>
      <note>
       <simpara>
        Todos los puntos y comas en la cadena DSN son reemplazados por espacios,