(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
E_USER_DEPRECATED