26、PHP 8.4 新特性 - Deprecated attribute（弃用属性）

Deprecated 属性概述

PHP 8.4 引入了一个新的特性 Deprecated 属性，这使得开发者可以更加方便地标记和管理弃用的功能或方法，符合现代开发中对向后兼容和代码可维护性的需求。具体来说，Deprecated 属性让开发者能够明确标记某个类、方法、属性或常量已被弃用，从而向其他开发者发出警告，并在未来的版本中移除它们。

为什么引入 #[Deprecated] 属性？

在以前，开发者只能通过 DocBlock 注释（如 @deprecated）来标记弃用的功能。虽然这种方式有效，但它不具备强制性，且工具（如 IDE 或静态分析工具）只能通过解析注释来发现弃用信息。而 PHP 8.4 引入的 #[Deprecated] 属性则使得弃用标记更具语义化，且可以被更好地集成到 PHP 语言本身的功能中。

此外，弃用标记不仅仅是对开发者的提醒，它还可以为最终用户和开发工具（如静态分析器、IDE）提供更明确的警告信息。

Deprecated 语法

PHP 8.4 中的 #[Deprecated] 属性可以与类、方法一起使用。其基本语法为：

#[Deprecated(?string $message = null, ?string $since = null)]

Deprecated 使用

弃用函数

<?php

declare(strict_types=1);

#[\Deprecated(message: '该方法将弃用', since: '1.3')]
function  getName()
{
    echo '我叫王美丽' . PHP_EOL;
}

getName();

输出

Deprecated: Function getName() is deprecated since 1.3, 该方法将弃用 in 
我叫王美丽

弃用类方法

<?php

declare(strict_types=1);

class User
{
//    #[\Deprecated(message: '该属性将弃用,请使用新的属性', since:'1.0')]
    public string $name = '王美丽';

    public string $username = '王美丽';

    #[\Deprecated(message: '访方法即将弃用，请使用新方法', since:'1.0')]
    public function getUser(): string
    {
        return $this->name;
    }

    public function getUserinfo(): string
    {
        return $this->username;
    }
}

$user = new User;

echo $user->username;
echo $user->getUserinfo();

注意，不能对类属性弃用，不然会报错。

Deprecated：允许的目标：函数、方法、类常量