钩子文档

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.