apply_filters() 函数用来创建一个过滤器,大多数被用在函数中,是 WordPress 插件机制中非常重要的一个函数,能让其它的主题和插件对一个值进行修改过滤。

用法

1

apply_filters($tag,$value,$var...);

参数

$tag

(字符串)(必须) 过滤器的名字。

默认值:None

$value

(混合)(必须) 要过滤的值,如果没人过滤则直接返回这个值。

$var

(混合)(可选) 传给过滤函数额外的变量参数,辅助过滤函数对返回值进行操作,可以添加无限个。

返回值

(混合) 过滤后的值,如果没人过滤则直接返回 $value 的值。

例子

没人过滤:

1

echoapply_filters('test','可以被修改的值');

打印结果:

可以被修改的值

有人过滤:

functiontest_func(){

    return'修改值';

}

add_filter('test','test_func');

echoapply_filters('test','可以被修改的值');

打印结果:

修改值

接收参数:

functiontest_func(){

    return'修改值';

}

add_filter('test','test_func');

functiontest_func2($text){

    return$text.'2';

}

add_filter('test','test_func2');

echoapply_filters('test','可以被修改的值');

多个参数:

functiontest_func($text,$var,$var2){

    return'修改值'.$var1.$var2;

}

add_action('test','test_func',10,3);

echoapply_filters('test','可以被修改的值','辅助值 1','辅助值 2');

其它

此函数位于:wp-includes/plugin.php

相关的函数:https://www.weixiaoduo.com/tag/hook