deprecated_function_run
云策文档标注
概述
deprecated_function_run 是一个 WordPress Hook,当调用已弃用的函数时触发。它用于通知开发者函数已过时,并提供替代方案和弃用版本信息。
关键要点
- 触发时机:当调用一个已弃用的函数时,此 Hook 会被激活。
- 参数说明:$function_name 表示被调用的函数名,$replacement 表示应使用的替代函数,$version 表示 WordPress 弃用该函数的版本。
- 相关函数:与 _deprecated_function() 配合使用,用于标记和报告弃用函数。
代码示例
do_action( 'deprecated_function_run', $function_name, $replacement, $version );注意事项
此 Hook 主要用于调试和日志记录,帮助开发者识别和更新代码中的弃用函数,以避免未来兼容性问题。
原文内容
Fires when a deprecated function is called.
Parameters
$function_namestring-
The function that was called.
$replacementstring-
The function that should have been called.
$versionstring-
The version of WordPress that deprecated the function.
Source
do_action( 'deprecated_function_run', $function_name, $replacement, $version );
Changelog
| Version | Description |
|---|---|
| 2.5.0 | Introduced. |