array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'class.returntypewillchange.php', 1 => 'ReturnTypeWillChange', 2 => 'El atributo ReturnTypeWillChange', ), 'up' => array ( 0 => 'reserved.attributes.php', 1 => 'Atributos predefinidos', ), 'prev' => array ( 0 => 'override.construct.php', 1 => 'Override::__construct', ), 'next' => array ( 0 => 'returntypewillchange.construct.php', 1 => 'ReturnTypeWillChange::__construct', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'language/predefined/attributes/returntypewillchange.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.returntypewillchange.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

El atributo ReturnTypeWillChange

(PHP 8 >= 8.1.0)

Introducción

A partir de PHP 8.1.0, comenzó una fase tentativa de transición hacia las declaraciones de tipo de retorno para los métodos de las clases internas.

La mayoría de los métodos internos no finales requieren ahora que los métodos sobrescritos declaren un tipo de retorno compatible. En caso contrario, se emite un aviso de deprecación durante la validación de herencia, advirtiendo de que la firma infringe las reglas de covarianza.

En una versión futura de PHP, la comprobación de las firmas de los métodos será estricta, y las discrepancias provocarán un error fatal.

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, o cuando el método sobrescrito declare un tipo de retorno incompatible, se puede añadir un atributo #[\ReturnTypeWillChange] para silenciar el aviso de deprecación.

Advertencia

Al sobrescribir métodos definidos en clases definidas por el usuario, los tipos de retorno se comprueban de forma estricta. Se emite un error fatal en caso de discrepancia, incluso si el método sobrescrito está marcado con el atributo.

El atributo ReturnTypeWillChange suprime los avisos de deprecación únicamente durante la fase de tipo de retorno tentativo. Una vez impuesta la comprobación estricta de tipos, el atributo dejará de funcionar y una discrepancia en la firma del método sobrescrito de una clase interna provocará un error fatal.

Sinopsis de la clase

#[\Attribute]
final class ReturnTypeWillChange {
/* Métodos */
public function __construct()
}

Tabla de contenidos