触发附加到已弃用的过滤器挂钩的函数。

原型

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/