Skip to content

[Sync EN] ReturnTypeWillChange: Add warning about future strict return type #788

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
Jun 15, 2026
+17 −3
Merged

[Sync EN] ReturnTypeWillChange: Add warning about future strict return type #788

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
20 changes: 17 additions & 3 deletions language/predefined/attributes/returntypewillchange.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: 77325b622f91355b118e8f3bc9ff940e8201f55d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 0019a7e201442447fd746c2852d28ba839ed15ae Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: Marqitos-->
<reference xml:id="class.returntypewillchange" 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>El atributo ReturnTypeWillChange</title>
Expand All @@ -9,12 +9,26 @@

<section xml:id="returntypewillchange.intro">
&reftitle.intro;
<para>
<simpara>
La mayoría de los métodos internos no finales requieren ahora que los métodos sobrescritos declaren
un tipo de retorno compatible, de lo contrario se emite un aviso de deprecación durante la validación de herencia.
Esto introduce una fase de tipo de retorno tentativo: el motor emite un aviso de deprecación
en lugar de un error fatal cuando los tipos de retorno son incompatibles, antes de que se vuelvan
obligatorios en una versión futura.
En caso de que el tipo de retorno no pueda declararse para un método sobrescrito debido a preocupaciones de compatibilidad entre versiones de PHP,
se puede añadir un atributo <code>#[\ReturnTypeWillChange]</code> para silenciar el aviso de deprecación.
</para>
</simpara>

<warning>
<simpara>
El atributo <classname>ReturnTypeWillChange</classname> suprime los avisos de deprecación
<emphasis>únicamente</emphasis> durante la fase de tipo de retorno tentativo.
No tiene efecto al sobrescribir métodos definidos en clases definidas por el usuario.
Una vez que los métodos internos adopten tipos estrictos, las discrepancias en las firmas de los
métodos sobrescritos provocarán un error fatal y este atributo dejará de tener efecto.
</simpara>
</warning>

</section>

<section xml:id="returntypewillchange.synopsis">
Expand Down