O atributo Deprecated

(PHP 8 >= 8.4.0)

Introdução

Este atributo é usado para marcar uma funcionalidade como descontinuada. Usar uma funcionalidade descontinuada causará a emissão de um erro E_USER_DEPRECATED.

Resumo da classe

final class Deprecated {
/* Propriedades */
public readonly ?string $message;
public readonly ?string $since;
/* Métodos */
public __construct(?string $message = null, ?string $since = null)
}

Propriedades

message

Uma mensagem opcional explicando o motivo da descontinuação e a possível funcionalidade de substituição. Será incluída na mensagem de descontinuação emitida.

since

Uma string opcional que indica desde quando a funcionalidade foi descontinuada. Os conteúdos não são validados pelo PHP e podem conter um número de versão, uma data ou qualquer outro valor que seja considerado apropriado. Será incluída na mensagem de descontinuação emitida.

A funcionalidade que fizer parte do PHP usará a versão principal.secundária como o valor de since, por exemplo '8.4'

Exemplos

<?php

#[\Deprecated(message: "use safe_replacement() instead", since: "1.5")]
function unsafe_function()
{
   echo "Isto não é seguro", PHP_EOL;
}

unsafe_function();

?>

A saída do exemplo acima no PHP 8.4 é semelhante a:

Deprecated: Function unsafe_function() is deprecated since 1.5, use safe_replacement() instead in example.php on line 9
Isto não é seguro

Veja Também

Table of Contents