# Deprecated 属性

(PHP 8 >= 8.4.0)

## 简介

此属性用于将功能标记为已弃用。使用已弃用的功能将导致发出 `E_USER_DEPRECATED` 错误。

## 类摘要

#[\Attribute]
final class Deprecated {
/* 属性 */
public readonly ?string $message;
public readonly ?string $since;
/* 方法 */
public function __construct(?string `$message` = null, ?string `$since` = null)
}

## 属性

message

  可选的消息，说明弃用的原因和可能的替代功能。将包含在发出的弃用消息中。

since

  可选的字符串，指示功能从何时起被弃用。内容不会被 PHP 验证，可以包含版本号、日期或任何被认为合适的值。将包含在发出的弃用消息中。

  PHP 自身的功能将使用 Major.Minor 作为 since 值，例如 `'8.4'`。

## 示例

    <?php

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

    unsafe_function();

    ?>

上述示例在 PHP 8.4 中的输出类似于：

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

## 参见

- 注解概述
- ReflectionFunctionAbstract::isDeprecated()
- ReflectionClassConstant::isDeprecated()
- `E_USER_DEPRECATED`

## 目录

- Deprecated::__construct — 构造新的 Deprecated 属性实例

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