调用添加到过滤器挂钩的函数。

原型

apply_filters( string $tag, mixed $value )

描述

通过调用此函数调用附加到filter hook $ tag的回调函数。通过使用$ tag参数指定的新挂钩的名称调用此函数,可以使用此函数创建新的过滤器挂钩。

参数

$tag (string) (Required) 过滤器挂钩的名称。

$value (mixed) (Required) 应用过滤器挂钩到$ tag的值。

$var,... (mixed) (Required) 传递给函数的其他变量挂钩到$ tag。

返回值

(mixed)  所有挂钩函数后的过滤值都应用于它。

源文件

路径:wp-includes/plugin.php

<?php
...
function apply_filters( $tag, $value ) {
	global $wp_filter, $wp_current_filter;
	$args = array();
	// Do 'all' actions first.
	if ( isset($wp_filter['all']) ) {
		$wp_current_filter[] = $tag;
		$args = func_get_args();
		_wp_call_all_hook($args);
	}
	if ( !isset($wp_filter[$tag]) ) {
		if ( isset($wp_filter['all']) )
			array_pop($wp_current_filter);
		return $value;
	}
	if ( !isset($wp_filter['all']) )
		$wp_current_filter[] = $tag;
	if ( empty($args) )
		$args = func_get_args();
	// don't pass the tag name to WP_Hook
	array_shift( $args );
	$filtered = $wp_filter[ $tag ]->apply_filters( $value, $args );
	array_pop( $wp_current_filter );
	return $filtered;
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/apply_filters/