# 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

#[\Attribute]
final class Deprecated {
/* Propriedades */
public readonly ?string $message;
public readonly ?string $since;
/* Métodos */
public function __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

- Visão geral de atributos
- ReflectionFunctionAbstract::isDeprecated()
- ReflectionClassConstant::isDeprecated()
- `E_USER_DEPRECATED`

## Índice

- Deprecated::__construct — Constrói uma nova instância do atributo Deprecated

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open