Skip to content

[Sync-En] Document the PHP 8.5 new warnings and exceptions #1312

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

Merged
julionc merged 1 commit into from
Sep 18, 2026
Merged

[Sync-En] Document the PHP 8.5 new warnings and exceptions #1312

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
42 changes: 39 additions & 3 deletions reference/bzip2/functions/bzcompress.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5fdeb11b137c94a6d25cbe98a2e14c00366197cf Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9ac246c4cf437dae2bf18fd3714545d7a0a51091 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.bzcompress">
<refnamediv>
Expand Down Expand Up @@ -49,7 +49,8 @@
es un valor especial).
</simpara>
<simpara>
Fuera de <parameter>work_factor</parameter>, el resultado será el mismo.
Independientemente del valor de <parameter>work_factor</parameter>, el resultado
generado es el mismo.
</simpara>
</listitem>
</varlistentry>
Expand All @@ -61,14 +62,47 @@
La cadena comprimida o un número de error si ocurre un error.
</simpara>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<simpara>
A partir de PHP 8.5.0, se lanza una <exceptionname>ValueError</exceptionname> si
<parameter>block_size</parameter> no está entre 1 y 9, o si
<parameter>work_factor</parameter> no está entre 0 y 250.
</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>
Ahora se lanza una <exceptionname>ValueError</exceptionname> si
<parameter>block_size</parameter> no está entre 1 y 9, o si
<parameter>work_factor</parameter> no está entre 0 y 250.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Compresión de datos</title>
<programlisting role="php">
<![CDATA[
<?php
$str = "datos simples";
$str = "datos de ejemplo";
$bzstr = bzcompress($str, 9);
echo $bzstr;
?>
Expand All @@ -80,6 +114,8 @@ echo $bzstr;
&reftitle.seealso;
<simplelist>
<member><function>bzdecompress</function></member>
<member><function>bzopen</function></member>
<member><function>gzcompress</function></member>
</simplelist>
</refsect1>
</refentry>
Expand Down
20 changes: 19 additions & 1 deletion reference/fileinfo/functions/finfo-file.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 82ddd2ec8ad195035dcb57dd8f97d27b83ddc126 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9ac246c4cf437dae2bf18fd3714545d7a0a51091 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.finfo-file">
<refnamediv>
Expand Down Expand Up @@ -75,6 +75,16 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lanza una <exceptionname>ValueError</exceptionname> si
<parameter>filename</parameter> contiene bytes nulos.
Antes de PHP 8.5.0, se lanzaba una <exceptionname>TypeError</exceptionname>
en su lugar.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand All @@ -86,6 +96,14 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Ahora se lanza una <exceptionname>ValueError</exceptionname> en lugar de una
<exceptionname>TypeError</exceptionname> cuando <parameter>filename</parameter>
contiene bytes nulos.
</entry>
</row>
&fileinfo.changelog.finfo-object;
<row>
<entry>8.0.0</entry>
Expand Down
31 changes: 21 additions & 10 deletions reference/mysqli/mysqli/construct.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9dadf74254fa743db43e73ab3f5a3d441c271ab1 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9ac246c4cf437dae2bf18fd3714545d7a0a51091 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli.construct" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -25,7 +25,7 @@
<modifier>public</modifier> <type>bool</type><methodname>mysqli::connect</methodname>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>hostname</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>username</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><modifier role="attribute">#[\SensitiveParameter]</modifier><type class="union"><type>string</type><type>null</type></type><parameter>password</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><modifier role="attribute">#[\SensitiveParameter]</modifier><type class="union"><type>string</type><type>null</type></type><parameter>password</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>database</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>port</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>socket</parameter><initializer>&null;</initializer></methodparam>
Expand Down Expand Up @@ -135,14 +135,18 @@
&return.falseforfailure;.
</para>
<para>
<methodname>mysqli::connect</methodname> devuelve &true; en caso de éxito &return.falseforfailure;.
Anterior a PHP 8.1.0, devuelve &null; en caso de éxito.
<methodname>mysqli::connect</methodname> devuelve &true; en caso de éxito&return.falseforfailure;.
Antes de PHP 8.1.0, devuelve &null; en caso de éxito.
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
&mysqli.conditionalexception;
<simpara>
A partir de PHP 8.5.0, llamar al constructor sobre un objeto ya construido
lanza un <exceptionname>Error</exceptionname>.
</simpara>
</refsect1>

<refsect1 role="changelog">
Expand All @@ -157,6 +161,13 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Llamar al constructor sobre un objeto ya construido ahora lanza
un <exceptionname>Error</exceptionname>.
</entry>
</row>
<row>
<entry>8.1.0</entry>
<entry>
Expand All @@ -170,8 +181,8 @@
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</tgroup>
</informaltable>
</para>
</refsect1>

Expand Down Expand Up @@ -275,24 +286,24 @@ if (mysqli_errno($mysqli)) {
Para verificar si la conexión falló, utilice la función
<function>mysqli_connect_error</function> o la propiedad
<link linkend="mysqli.connect-error">mysqli-&gt;connect_error</link>
como en el ejemplo anterior.
como en los ejemplos anteriores.
</para>
</note>
<note>
<para>
Si es necesario configurar opciones, como el tiempo de espera de conexión,
<function>mysqli_real_connect</function> debe ser utilizado.
se debe utilizar <function>mysqli_real_connect</function> en su lugar.
</para>
</note>
<note>
<para>
Llamar al constructor sin parámetros tiene el mismo efecto que llamar
Llamar al constructor sin parámetros tiene el mismo efecto que llamar a
<function>mysqli_init</function>.
</para>
</note>
<note>
<para>
El error <literal>"Can't create TCP/IP socket (10106)"</literal> significa generalmente que la directiva de configuración
El error "Can't create TCP/IP socket (10106)" significa generalmente que la directiva de configuración
<link linkend="ini.variables-order">variables_order</link> no contiene el
carácter <literal>E</literal>. En Windows, si el entorno no se copia,
la variable de entorno <literal>SYSTEMROOT</literal> no estará disponible
Expand Down
49 changes: 46 additions & 3 deletions reference/pcntl/functions/pcntl-exec.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 253f4bdd29fc3938030dce22882611ceefa9f74a Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9ac246c4cf437dae2bf18fd3714545d7a0a51091 Maintainer: PhilDaiguille Status: ready -->
<refentry xml:id="function.pcntl-exec" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pcntl_exec</refname>
Expand All @@ -15,7 +15,7 @@
<methodparam choice="opt"><type>array</type><parameter>env_vars</parameter><initializer>[]</initializer></methodparam>
</methodsynopsis>
<para>
Ejecuta el programa indicado en el espacio actual de procesos.
Ejecuta el programa con los argumentos indicados.
</para>
</refsect1>

Expand Down Expand Up @@ -48,7 +48,7 @@
<term><parameter>env_vars</parameter></term>
<listitem>
<para>
<parameter>env_vars</parameter> es un array de strings que son pasadas
<parameter>env_vars</parameter> es un array de strings que son pasados
al programa como variables de entorno.
El array es de la forma nombre =&gt; valor, la clave es el nombre de la variable de entorno
y el valor es el valor de esta variable.
Expand All @@ -67,6 +67,49 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
A partir de PHP 8.5.0, se lanza una <exceptionname>ValueError</exceptionname> si
alguna entrada de <parameter>args</parameter> contiene un byte nulo, o si
alguna entrada o clave de <parameter>env_vars</parameter> contiene un byte nulo.
</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>
Ahora se lanza una <exceptionname>ValueError</exceptionname> si alguna entrada de
<parameter>args</parameter> contiene un byte nulo, o si alguna entrada o
clave de <parameter>env_vars</parameter> contiene un byte nulo.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>pcntl_fork</function></member>
<member><function>pcntl_waitpid</function></member>
<member><function>exec</function></member>
<member><function>proc_open</function></member>
</simplelist>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Expand Down
34 changes: 29 additions & 5 deletions reference/session/functions/session-start.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 151e61773c016edcae8fd4989ad9a86ffd03c283 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9ac246c4cf437dae2bf18fd3714545d7a0a51091 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.session-start" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -39,7 +39,7 @@
gestor interno de salida para la reescritura de URLs.
</para>
<para>
Si un usuario utiliza <literal>ob_gzhandler</literal> o el equivalente
Si un usuario utiliza <literal>ob_gzhandler</literal> o similar con
<function>ob_start</function>, el orden de llamada de las funciones es importante
para una salida correcta. Por ejemplo,
<literal>ob_gzhandler</literal> debe ser registrado antes de iniciar la sesión.
Expand All @@ -60,8 +60,8 @@
</para>
<para>
Además del conjunto normal de directivas de configuración, una opción
<literal>read_and_close</literal> puede también ser proporcionada. Si la
valor es definido como &true;, esto provoca el cierre inmediato de
<literal>read_and_close</literal> puede también ser proporcionada. Si el
valor se define como &true;, esto provoca el cierre inmediato de
la sesión después de la lectura, lo que evita cualquier bloqueo innecesario si los
datos de sesión no son modificados.
</para>
Expand All @@ -77,6 +77,20 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
A partir de PHP 8.5.0, se lanza una <exceptionname>ValueError</exceptionname> si
<parameter>options</parameter> contiene alguna clave que no sea de tipo string.
</simpara>
<simpara>
A partir de PHP 8.5.0, se lanza una <exceptionname>TypeError</exceptionname> si la
opción <literal>read_and_close</literal> no es de tipo <type>string</type>,
<type>int</type> o <type>bool</type>, o si su valor no puede interpretarse
como un <type>int</type>.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<para>
Expand All @@ -89,6 +103,16 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Ahora lanza una <exceptionname>ValueError</exceptionname> si el array
<parameter>options</parameter> contiene claves que no son de tipo string,
y una <exceptionname>TypeError</exceptionname> si el valor de
<literal>read_and_close</literal> no es compatible con
<type>int</type>.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
Expand Down Expand Up @@ -213,7 +237,7 @@ session_start([
<note>
<para>
El uso de
<link linkend="ini.zlib.output-compression"><option>zlib.output_compression</option></link>
<link linkend="ini.zlib.output-compression">zlib.output_compression</link>
es recomendado, en lugar de <function>ob_gzhandler</function>.
</para>
</note>
Expand Down
Loading