WordPress开发函数apply_filters_deprecated()，触发附加在废弃过滤器钩子上的函数。
用法：
apply_filters_deprecated( string $tag, array $args, string $version, string $replacement = ”, string $message = ” )
描述
当筛选器钩子被弃用时，apply_filters()调用会被apply_filters_deprecated()替换，它会触发弃用通知，然后触发原始的筛选器钩子。
注意:传递给原始apply_filters()调用的值和额外参数必须在这里以数组形式传递给$args。例如:
// Old filter.
return apply_filters( ‘wpdocs_filter’, $value, $extra_arg );
// Deprecated.
return apply_filters_deprecated( ‘wpdocs_filter’, array( $value, $extra_arg ), ‘4.9.0’, ‘wpdocs_new_filter’ );
参见also
_deprecated_hook ()
参数：
$tag
(string) (必需) 过滤器钩子的名称。
$args
(array) (必需) 传递给apply_filters()的附加函数参数的数组。
$version
(string) (必需) 反对钩子的WordPress版本。
$replacement
(string) (可选) 应该用的钩子。
默认值: ”
$message
(string) (可选) 关于变更的消息
默认值: ”
来源
文件: wp-includes/plugin.php
function apply_filters_deprecated( $tag, $args, $version, $replacement = ”, $message = ” ) {
if ( ! has_filter( $tag ) ) {
return $args[0];
}
_deprecated_hook( $tag, $version, $replacement, $message );
return apply_filters_ref_array( $tag, $args );
}
更新日志：
