描述
每当使用不推荐使用的函数参数时,都将使用此函数。在调用此函数之前,必须通过将参数与其默认值进行比较或评估参数是否为空来检查参数是否已被使用。例如:
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 | 开始引入 |