From 5efa6c966c1dbb15ca8e30829b1aca8a168935a5 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Wed, 2 Sep 2026 09:59:24 +0200 Subject: [PATCH] sync: document PHP 8.5 PDO fetch mode changes and deprecations - pdo.xml: add 8.5.0 changelog (driver-specific constants deprecated) - construct.xml: add uri: DSN deprecation warning, errors para->simpara, add 8.5.0 changelog section - fetchall.xml: add 8.5.0 changelog (FETCH_INTO / FETCH_PROPS_LATE changes) - setattribute.xml: add errors section and 8.5.0 changelog (Firebird cursor name) - setfetchmode.xml: update constructorArgs description, add errors section, add two 8.5.0 changelog rows (CUFA semantics, Error during fetch) - Update EN-Revision to e16d04c436e9801627139c67c1cabcb92b469ccc --- reference/pdo/pdo.xml | 14 ++++++- reference/pdo/pdo/construct.xml | 38 ++++++++++++++++--- reference/pdo/pdostatement/fetchall.xml | 14 ++++++- reference/pdo/pdostatement/setattribute.xml | 36 +++++++++++++++++- reference/pdo/pdostatement/setfetchmode.xml | 42 ++++++++++++++++++--- 5 files changed, 128 insertions(+), 16 deletions(-) diff --git a/reference/pdo/pdo.xml b/reference/pdo/pdo.xml index 9f9daa7662..6c56e1b6cb 100644 --- a/reference/pdo/pdo.xml +++ b/reference/pdo/pdo.xml @@ -1,6 +1,5 @@ - - + La clase PDO PDO @@ -497,6 +496,17 @@ + + 8.5.0 + + Las constantes específicas del controlador de la clase PDO + han sido marcadas como obsoletas en favor de las constantes equivalentes de las + subclases específicas del controlador (Pdo\Dblib, + Pdo\Firebird, Pdo\Mysql, + Pdo\Odbc, Pdo\Pgsql, + Pdo\Sqlite). + + 8.4.0 diff --git a/reference/pdo/pdo/construct.xml b/reference/pdo/pdo/construct.xml index 58fce46a1b..b5f8f8ed11 100644 --- a/reference/pdo/pdo/construct.xml +++ b/reference/pdo/pdo/construct.xml @@ -1,6 +1,5 @@ - - + PDO::__construct @@ -58,6 +57,13 @@ la cadena DSN. La URI puede especificar un fichero local o remoto. uri:file:///path/to/dsnfile + + + El esquema DSN uri: está obsoleto a partir de + PHP 8.5.0 debido a problemas de seguridad con los DSN provenientes de + URIs remotas. + + Alias @@ -112,11 +118,33 @@ &reftitle.errors; - - Se lanza una excepción PDOException si el intento + + Se lanza una excepción PDOException si el intento de conexión a la base de datos solicitada falla, independientemente del PDO::ATTR_ERRMODE actualmente definido. - + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.5.0 + + El esquema DSN uri: está ahora obsoleto. + + + + + diff --git a/reference/pdo/pdostatement/fetchall.xml b/reference/pdo/pdostatement/fetchall.xml index 63f5c18a33..9577d514d5 100644 --- a/reference/pdo/pdostatement/fetchall.xml +++ b/reference/pdo/pdostatement/fetchall.xml @@ -1,6 +1,5 @@ - - + PDOStatement::fetchAll @@ -153,6 +152,17 @@ + + 8.5.0 + + El uso de PDO::FETCH_INTO como modo de recuperación ahora lanza un + ValueError, de manera similar a + PDO::FETCH_LAZY. + El uso de PDO::FETCH_PROPS_LATE con un modo de recuperación + distinto de PDO::FETCH_CLASS ahora lanza un + ValueError. + + 8.0.0 diff --git a/reference/pdo/pdostatement/setattribute.xml b/reference/pdo/pdostatement/setattribute.xml index 6673fc17fb..05b67536f6 100644 --- a/reference/pdo/pdostatement/setattribute.xml +++ b/reference/pdo/pdostatement/setattribute.xml @@ -1,6 +1,5 @@ - - + PDOStatement::setAttribute @@ -66,6 +65,39 @@ + + &reftitle.errors; + + A partir de PHP 8.5.0, cuando se usa el controlador Firebird, se lanza un + ValueError si el nombre de cursor establecido mediante + PDO::ATTR_CURSOR_NAME es demasiado largo. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.5.0 + + Al usar el controlador Firebird, ahora se lanza un ValueError + si el nombre de cursor establecido mediante + PDO::ATTR_CURSOR_NAME es demasiado largo. + + + + + + + &reftitle.seealso; diff --git a/reference/pdo/pdostatement/setfetchmode.xml b/reference/pdo/pdostatement/setfetchmode.xml index e1f5f141d9..49f84118db 100644 --- a/reference/pdo/pdostatement/setfetchmode.xml +++ b/reference/pdo/pdostatement/setfetchmode.xml @@ -1,6 +1,5 @@ - - + PDOStatement::setFetchMode @@ -68,9 +67,12 @@ constructorArgs - - Argumentos del constructor. - + + Argumentos del constructor. A partir de PHP 8.5.0, las claves de tipo string + actúan como argumentos con nombre. Para pasar una variable por referencia, + se utiliza un elemento de referencia: + $constructorArgs = [&$valByRef]. + @@ -92,6 +94,16 @@ + + &reftitle.errors; + + A partir de PHP 8.5.0, se lanza un Error si este método + es llamado durante una llamada a PDOStatement::fetch, + PDOStatement::fetchObject o + PDOStatement::fetchAll. + + + &reftitle.changelog; @@ -103,6 +115,26 @@ + + 8.5.0 + + El constructorArgs para + PDO::FETCH_CLASS ahora sigue la semántica CUFA + (call_user_func_array): las claves de tipo string actúan + como argumentos con nombre, y la envoltura automática de argumentos por valor + para parámetros por referencia ha sido eliminada. + + + + 8.5.0 + + Llamar a este método durante una llamada a + PDOStatement::fetch, + PDOStatement::fetchObject o + PDOStatement::fetchAll ahora lanza un + Error. + + &return.type.true.84;