当前浏览:首页 / WordPress函数 / _deprecated_argument()

_deprecated_argument( string $function, string $version, string $message = '' )

将函数参数标记为已弃用,并在使用时通知

day

  • is_day() 是否为现有的日期存档
  • is_new_day() 循环中当前文章的发布日期是否与循环中上一篇文章的发布日期不同

loaded

  • plugins_loaded 加载已启用的插件后触发
  • wp_loaded 一旦WP、所有插件和主题被完全加载和实例化,这个钩子就会被触发

描述

每当使用不推荐使用的函数参数时,都将使用此函数。在调用此函数之前,必须通过将参数与其默认值进行比较或评估参数是否为空来检查参数是否已被使用。例如:

if ( ! empty( $deprecated ) ) {
    _deprecated_argument( __FUNCTION__, '3.0.0' );
}

将调用一个钩子deprecated_argument_run,该钩子可用于回溯到使用不推荐的参数的文件和函数。

如果WP_DEBUG为真,则当前行为将触发用户错误。


参数

$function

(string)(必填) 调用的函数。

$version

(string)(必填) 不推荐使用的参数的WordPress版本。

$message

(string)(可选) 关于更改的消息。

默认值: ''



源码

查看源码 官方文档


更新日志

版本描述
5.4.0错误类型现在分类为E_USER_DEPRECATED(用于默认为E_USER_NOTICE)
3.0.0开始引入