Deprecated 属性
(PHP 8 >= 8.4.0)
类摘要
#[\Attribute(
\Attribute::TARGET_METHOD
| \Attribute::TARGET_FUNCTION
| \Attribute::TARGET_CLASS_CONSTANT
| \Attribute::TARGET_CONSTANT
| \Attribute::TARGET_CLASS,
)]
final class Deprecated {
\Attribute::TARGET_METHOD
| \Attribute::TARGET_FUNCTION
| \Attribute::TARGET_CLASS_CONSTANT
| \Attribute::TARGET_CONSTANT
| \Attribute::TARGET_CLASS,
)]
final class Deprecated {
/* 属性 */
/* 方法 */
}属性
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 目标实现。
|
目录
- Deprecated::__construct — 构造新的 Deprecated 属性实例
来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。
