大网数据广告活动
PHP 语言与运行手册

Deprecated 属性

· 52CE 我爱测

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

Deprecated 属性

(PHP 8 >= 8.4.0)

简介

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

自 PHP 8.5.0 起,此属性也可以应用于 trait 和类外声明的编译时常量。

类摘要

/* 属性 */
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

更新日志

版本 说明
8.5.0 Deprecated 现在也可以应用于 trait 和类外声明的编译时常量;后者通过新的 Attribute::TARGET_CONSTANT 目标实现。

目录

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。