(PHP 8 >= 8.4.0)
Este atributo é usado para marcar uma funcionalidade como descontinuada.
Usar uma funcionalidade descontinuada causará a emissão de um erro E_USER_DEPRECATED.
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.
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'
<?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
Here is a bit of wisdom from the Attribute parser:
Fatal error: Attribute "Deprecated" cannot target parameter (allowed targets: function, method, class constant)
<?php
function unsafe_function(
#[\Deprecated(message: "don't use hello param anymore", since: "1.5")]
string $hello,
) {
echo "This is unsafe", PHP_EOL;
}