触发附加到已弃用的过滤器挂钩的函数。
原型
apply_filters_deprecated( string $tag, array $args, string $version, string $replacement = false, string $message = null )
描述
不推荐使用过滤器挂钩时,apply_filters()调用将替换为apply_filters_deprecated(),它会触发弃用通知,然后触发原始过滤器挂钩。
参考:
- _deprecated_hook()
参数
$tag
(string)
(Required)
过滤器挂钩的名称。
$args
(array)
(Required)
要传递给apply_filters()的其他函数参数的数组。
$version
(string)
(Required)
弃用了钩子的WordPress版本。
$replacement
(string)
(Optional)
应该使用的钩子。
$message
(string)
(Optional)
有关更改的消息。
源文件
路径:wp-includes/plugin.php
<?php
...
function apply_filters_deprecated( $tag, $args, $version, $replacement = false, $message = null ) {
if ( ! has_filter( $tag ) ) {
return $args[0];
}
_deprecated_hook( $tag, $version, $replacement, $message );
return apply_filters_ref_array( $tag, $args );
}
...
?>
其他
英文文档:https://developer.wordpress.org/reference/functions/apply_filters_deprecated/