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