array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'class.deprecated.php', 1 => 'Deprecated', 2 => 'Deprecated 属性', ), 'up' => array ( 0 => 'reserved.attributes.php', 1 => '预定义注解', ), 'prev' => array ( 0 => 'allowdynamicproperties.construct.php', 1 => 'AllowDynamicProperties::__construct', ), 'next' => array ( 0 => 'deprecated.construct.php', 1 => 'Deprecated::__construct', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'language/predefined/attributes/deprecated.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.deprecated.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Deprecated 属性

(PHP 8 >= 8.4.0)

简介

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

类摘要

#[\Attribute]
final class Deprecated {
/* 属性 */
public readonly ?string $message;
public readonly ?string $since;
/* 方法 */
public __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

目录