2024 年 PHP 日本大会

    Deprecated 属性

    (PHP 8 >= 8.4.0)

    简介

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

    类概要

    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