# L'attribut Deprecated

(PHP 8 >= 8.4.0)

## Introduction

Cet attribut est utilisé pour marquer une fonctionnalité comme obsolète. L'utilisation d'une fonctionnalité obsolète entraînera l'émission d'une erreur `E_USER_DEPRECATED`.

## Synopsis de la classe

final class Deprecated {
/* Propriétés */
public readonly ?string $message;
public readonly ?string $since;
/* Méthodes */
public __construct(?string `$message` = `null`, ?string `$since` = `null`)
}

## Propriétés

message

  Un message optionnel expliquant la raison de l'obsolescence et la fonctionnalité de remplacement possible. Sera inclus dans le message d'obsolescence émis.

since

  Une chaîne optionnelle indiquant depuis quand la fonctionnalité est obsolète. Le contenu n'est pas validé par PHP et peut contenir un numéro de version, une date ou toute autre valeur considérée comme appropriée. Sera inclus dans le message d'obsolescence émis.

  Fonctionnalité qui fait partie de PHP utilisera Major.Minor comme valeur de since, par exemple `'8.4'`.

## Exemples

`<?php
#[\Deprecated(message: "use safe_replacement() instead", since: "1.5")]
function unsafe_function()
{
echo "This is unsafe", PHP_EOL;
}
unsafe_function();
?>`

La sortie de l'exemple ci-dessus en PHP 8.4 est similaire à :

    Deprecated: Function unsafe_function() is deprecated since 1.5, use safe_replacement() instead in example.php on line 9
    This is unsafe

## Voir aussi

- Aperçu des attributs
- ReflectionFunctionAbstract::isDeprecated()
- ReflectionClassConstant::isDeprecated()
- `E_USER_DEPRECATED`

## Sommaire

- Deprecated::__construct — Construit une nouvelle instance de l'attribut Deprecated