WordPress开发函数apply_filters_deprecated()

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 );

}

更新日志：