Skip to content

[Sync-En] document the PHP 8.5 core language features and deprecations #1285

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
PhilDaiguille merged 1 commit into from
Sep 8, 2026
Merged

[Sync-En] document the PHP 8.5 core language features and deprecations #1285

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
30 changes: 29 additions & 1 deletion appendices/ini.core.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: a52e3d27cca786940272d0ae8efc21b5d6739070 Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: cf7dcffba0ab8ce14dbfd6019f2861f5a6843ed5 Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->

<section xml:id="ini.core" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
Expand Down Expand Up @@ -392,6 +392,12 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.max-memory-limit">max_memory_limit</link></entry>
<entry>"-1"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponible a partir de PHP 8.5.0</entry>
</row>
</tbody>
</tgroup>
</table>
Expand All @@ -415,6 +421,28 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk

</listitem>
</varlistentry>
<varlistentry xml:id="ini.max-memory-limit">
<term>
<parameter>max_memory_limit</parameter>
<type>int</type>
</term>
<listitem>
<simpara>
Disponible a partir de PHP 8.5.0. Esta opción, solo modificable al
arranque, controla el valor máximo al que puede configurarse
<link linkend="ini.memory-limit">memory_limit</link>, ya sea al arranque
o durante la ejecución (por ejemplo mediante
<function>ini_set</function>). Establecer
<link linkend="ini.memory-limit">memory_limit</link> a un valor que
supere <parameter>max_memory_limit</parameter> produce una advertencia
y el valor queda limitado. Establézcala a <literal>-1</literal>
(el valor por omisión) para no imponer ningún límite superior.
</simpara>

&ini.shorthandbytes;

</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Expand Down
35 changes: 34 additions & 1 deletion language/constants.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: 6e885e52412ad979aa5fbb620bb84e886fc0ebe8 Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: 4c352e683436649edba35a3272210d8ca4cae611 Maintainer: lacatoire Status: ready -->
<!-- Reviewed: yes -->
<chapter xml:id="language.constants" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
<title>Constantes</title>
Expand All @@ -21,6 +21,12 @@
</para>
</note>

<note>
<simpara>
A partir de PHP 8.5.0, redeclarar una constante ya definida está obsoleto.
</simpara>
</note>

<para>
El nombre de una constante sigue las mismas reglas que cualquier etiqueta
en PHP. Un nombre de constante válido comienza con una letra o guion bajo,
Expand Down Expand Up @@ -225,6 +231,33 @@ echo ANIMALS_DEF[1] . "\n"; // muestra "cat"
</para>
</note>

<sect2 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>
Se añadió el soporte de las conversiones de tipo (por ejemplo
<code>(int)</code>, <code>(string)</code>) en las expresiones
constantes. También se añadió el soporte de las
<link linkend="functions.anonymous">Closures</link> y de los
<link linkend="functions.first_class_callable_syntax">callables de
primera clase</link> en las expresiones constantes.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect2>

<sect2 role="seealso">
&reftitle.seealso;
<para>
Expand Down
26 changes: 25 additions & 1 deletion language/errors/basics.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: de9c65c91ff1710d8b2d2ec955caea0162679305 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 4c352e683436649edba35a3272210d8ca4cae611 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->

<sect1 xml:id="language.errors.basics" xmlns="http://docbook.org/ns/docbook">
Expand Down Expand Up @@ -77,6 +77,30 @@
tal como el envío de un correo electrónico.
</para>
</sect2>

<sect2 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>
Los errores fatales (como un tiempo máximo de ejecución superado) ahora
incluyen una traza de la pila en su mensaje de error.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect2>

</sect1>

<!-- Keep this comment at the end of the file
Expand Down
34 changes: 33 additions & 1 deletion language/functions.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: c19f29d4fcf92c1a2d2c46d68adab31e98fcbe78 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 4c352e683436649edba35a3272210d8ca4cae611 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
<title>Functions</title>
Expand Down Expand Up @@ -1418,6 +1418,14 @@ Stack trace:
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Las Closures ahora pueden usarse en expresiones constantes (por
ejemplo valores por omisión de propiedades, parámetros de atributos,
constantes).
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>
Expand Down Expand Up @@ -1725,6 +1733,30 @@ $obj?->prop->method(...);
</informalexample>
</para>
</note>

<sect2 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>
Los callables de primera clase ahora pueden usarse en expresiones
constantes (por ejemplo valores por omisión de propiedades, parámetros
de atributos, constantes).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect2>
</sect1>

</chapter>
Expand Down
6 changes: 5 additions & 1 deletion language/oop5/magic.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: dff848b17dafaabfb7662ffb5fecfcb04e3b771d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: cf7dcffba0ab8ce14dbfd6019f2861f5a6843ed5 Maintainer: PhilDaiguille Status: ready -->
<sect1 xml:id="language.oop5.magic" xmlns="http://docbook.org/ns/docbook">
<title>Métodos mágicos</title>
<simpara>
Expand Down Expand Up @@ -580,6 +580,10 @@ object(A)#2 (2) {
entonces todas las propiedades públicas, protegidas y privadas serán
mostradas.
</para>
<simpara>
A partir de PHP 8.5.0, devolver &null; desde <link linkend="object.debuginfo">__debugInfo()</link>
está obsoleto. Devuelva un <type>array</type> vacío en su lugar.
</simpara>
<example>
<title>Uso de <link linkend="object.debuginfo">__debugInfo()</link></title>
<programlisting role="php">
Expand Down
8 changes: 5 additions & 3 deletions language/operators/increment.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 16934048f79c6e117cd16a23c09c1b2ea502e284 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: cf7dcffba0ab8ce14dbfd6019f2861f5a6843ed5 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<sect1 xml:id="language.operators.increment">
<title>Operadores de incremento y decremento</title>
<titleabbrev>Incremento y decremento</titleabbrev>
<para>
PHP soporta los operadores de pre- y post- incremento y decremento.
Estos operadores unaires permiten aumentar o disminuir la valor de un.
Estos operadores unarios permiten aumentar o disminuir el valor en uno.
</para>
<table>
<title>Operadores de incremento y decremento</title>
Expand Down Expand Up @@ -131,6 +131,8 @@ int(4)
<simpara>
Esta funcionalidad es deprecada de manera suave a partir de PHP 8.3.0.
La función <function>str_increment</function> debe ser utilizada en su lugar.
A partir de PHP 8.5.0, incrementar strings no numéricos emite una advertencia
de obsolescencia.
</simpara>
</warning>

Expand All @@ -155,7 +157,7 @@ for ($n=0; $n<6; $n++) {
echo ++$s . PHP_EOL;
}
// Los strings alfanuméricos se comportan de manera diferente
echo '== Caracteres digitales ==' . PHP_EOL;
echo '== Strings alfanuméricos ==' . PHP_EOL;
$d = 'A8';
for ($n=0; $n<6; $n++) {
echo ++$d . PHP_EOL;
Expand Down
44 changes: 34 additions & 10 deletions language/predefined/closure/bind.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: 9c74079f12d67cabb52c124d761f48275417d7eb Maintainer: seros Status: ready -->
<!-- EN-Revision: cf7dcffba0ab8ce14dbfd6019f2861f5a6843ed5 Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<refentry xml:id="closure.bind" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand Down Expand Up @@ -30,40 +30,64 @@
<varlistentry>
<term><parameter>closure</parameter></term>
<listitem>
<para>
<simpara>
La función anónima a vincular.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>newThis</parameter></term>
<listitem>
<para>
<simpara>
El objeto al que la función anónima dada debería ser vinculado, o
&null; para que el cierre sea desvinculado.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>newScope</parameter></term>
<listitem>
<para>
<simpara>
El ámbito de clase a la que asociar el cierre, o
'static' para mantener el actual. Si se proporciona un objeto, el tipo del
mismo se usará en su lugar. Esto determina la visibilidad de métodos
protegidos y privados del objeto vinculado.
No se permite pasar (un objeto de) una clase interna a este parámetro.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un nuevo objeto <classname>Closure</classname> object, o &null; en caso de error.
</para>
<simpara>
Devuelve un nuevo objeto <classname>Closure</classname>, o &null; en caso de error.
</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>
Vincular una instancia a un cierre estático, o vincular un método de una
jerarquía de clases incompatible, ahora está obsoleto (estos casos ya
emitían un <constant>E_WARNING</constant>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
Expand Down
Loading