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

}

更新日志:

WordPress开发函数apply_filters_deprecated() (https://www.wpzt.net/) WordPress开发教程 第1张

发表评论

您的电子邮箱地址不会被公开。 必填项已用*标注