update page now

    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

    目录

    发现了问题？

    了解如何改进此页面 • 提交拉取请求 • 报告一个错误
    ＋添加备注

    用户贡献的备注

    此页面尚无用户贡献的备注。
    To Top