Skip to content

[Sync-En] ext/pdo: document the PHP 8.5 fetch mode changes and deprecations (#5817) #1226

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lacatoire wants to merge 1 commit into
base: master
Choose a base branch
from
Open

[Sync-En] ext/pdo: document the PHP 8.5 fetch mode changes and deprecations (#5817) #1226

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions reference/pdo/pdo.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: a78c7290730ac918c4eb6b199004d24051d1e93f Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: e16d04c436e9801627139c67c1cabcb92b469ccc Maintainer: PhilDaiguille Status: ready -->
<reference xml:id="class.pdo" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La clase PDO</title>
<titleabbrev>PDO</titleabbrev>
Expand Down Expand Up @@ -497,6 +496,17 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Las constantes específicas del controlador de la clase <classname>PDO</classname>
han sido marcadas como obsoletas en favor de las constantes equivalentes de las
subclases específicas del controlador (<classname>Pdo\Dblib</classname>,
<classname>Pdo\Firebird</classname>, <classname>Pdo\Mysql</classname>,
<classname>Pdo\Odbc</classname>, <classname>Pdo\Pgsql</classname>,
<classname>Pdo\Sqlite</classname>).
</entry>
</row>
<row>
<entry>8.4.0</entry>
<entry>
Expand Down
38 changes: 33 additions & 5 deletions reference/pdo/pdo/construct.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7dd805d34addc6e98afaa0b3851c8656afbec9b6 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: e16d04c436e9801627139c67c1cabcb92b469ccc Maintainer: PhilDaiguille Status: ready -->
<refentry xml:id="pdo.construct" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>PDO::__construct</refname>
Expand Down Expand Up @@ -58,6 +57,13 @@
la cadena DSN. La URI puede especificar un fichero local o remoto.
</para>
<para><userinput>uri:file:///path/to/dsnfile</userinput></para>
<warning>
<simpara>
El esquema DSN <userinput>uri:</userinput> está obsoleto a partir de
PHP 8.5.0 debido a problemas de seguridad con los DSN provenientes de
URIs remotas.
</simpara>
</warning>
</listitem>
</varlistentry>
<varlistentry><term>Alias</term>
Expand Down Expand Up @@ -112,11 +118,33 @@

<refsect1 role="errors">
&reftitle.errors;
<para>
Se lanza una excepción <classname>PDOException</classname> si el intento
<simpara>
Se lanza una excepción <exceptionname>PDOException</exceptionname> si el intento
de conexión a la base de datos solicitada falla,
independientemente del <constant>PDO::ATTR_ERRMODE</constant> actualmente definido.
</para>
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
El esquema DSN <userinput>uri:</userinput> está ahora obsoleto.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
Expand Down
14 changes: 12 additions & 2 deletions reference/pdo/pdostatement/fetchall.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: e16d04c436e9801627139c67c1cabcb92b469ccc Maintainer: PhilDaiguille Status: ready -->
<refentry xml:id="pdostatement.fetchall" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>PDOStatement::fetchAll</refname>
Expand Down Expand Up @@ -153,6 +152,17 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
El uso de <constant>PDO::FETCH_INTO</constant> como modo de recuperación ahora lanza un
<exceptionname>ValueError</exceptionname>, de manera similar a
<constant>PDO::FETCH_LAZY</constant>.
El uso de <constant>PDO::FETCH_PROPS_LATE</constant> con un modo de recuperación
distinto de <constant>PDO::FETCH_CLASS</constant> ahora lanza un
<exceptionname>ValueError</exceptionname>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Expand Down
36 changes: 34 additions & 2 deletions reference/pdo/pdostatement/setattribute.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: e16d04c436e9801627139c67c1cabcb92b469ccc Maintainer: PhilDaiguille Status: ready -->
<refentry xml:id="pdostatement.setattribute" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>PDOStatement::setAttribute</refname>
Expand Down Expand Up @@ -66,6 +65,39 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
A partir de PHP 8.5.0, cuando se usa el controlador Firebird, se lanza un
<exceptionname>ValueError</exceptionname> si el nombre de cursor establecido mediante
<constant>PDO::ATTR_CURSOR_NAME</constant> es demasiado largo.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Al usar el controlador Firebird, ahora se lanza un <exceptionname>ValueError</exceptionname>
si el nombre de cursor establecido mediante
<constant>PDO::ATTR_CURSOR_NAME</constant> es demasiado largo.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
Expand Down
42 changes: 37 additions & 5 deletions reference/pdo/pdostatement/setfetchmode.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8a910daad2efdfd29acf6766be8bca7c32c3dd2a Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: e16d04c436e9801627139c67c1cabcb92b469ccc Maintainer: PhilDaiguille Status: ready -->
<refentry xml:id="pdostatement.setfetchmode" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>PDOStatement::setFetchMode</refname>
Expand Down Expand Up @@ -68,9 +67,12 @@
<varlistentry>
<term><parameter>constructorArgs</parameter></term>
<listitem>
<para>
Argumentos del constructor.
</para>
<simpara>
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:
<code>$constructorArgs = [&amp;$valByRef]</code>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
Expand All @@ -92,6 +94,16 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
A partir de PHP 8.5.0, se lanza un <exceptionname>Error</exceptionname> si este método
es llamado durante una llamada a <methodname>PDOStatement::fetch</methodname>,
<methodname>PDOStatement::fetchObject</methodname> o
<methodname>PDOStatement::fetchAll</methodname>.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand All @@ -103,6 +115,26 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
El <parameter>constructorArgs</parameter> para
<constant>PDO::FETCH_CLASS</constant> ahora sigue la semántica CUFA
(<function>call_user_func_array</function>): 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.
</entry>
</row>
<row>
<entry>8.5.0</entry>
<entry>
Llamar a este método durante una llamada a
<methodname>PDOStatement::fetch</methodname>,
<methodname>PDOStatement::fetchObject</methodname> o
<methodname>PDOStatement::fetchAll</methodname> ahora lanza un
<exceptionname>Error</exceptionname>.
</entry>
</row>
&return.type.true.84;
</tbody>
</tgroup>
Expand Down
Loading