对Wordpress的这个filters的概念一直是一知半解(其实半解也算不上,只能算知道有这么个函数),最近遇到了Wordpress的头像问题,无可避免的又遇到过滤器。刚好在CSDN上看到某篇文章写得比较清楚,摘录顺便自己动手尝试一下,以加深一些印象。apply_filters有点儿类似一个卧底,被提前安排打入了黑帮内部,但他并不清楚自己需要做些什么,而add_filter则是他的联络人,出任务的时候,两人约定由add_filter将任务清单(回调函数)放入大众浴室的9527号储物箱内,所以apply_filters参与黑帮团建之前总会先去大众浴室看看储物箱内有没有新任务。
apply_filters()函数的用法
apply_filters(string $tag, mixed $value)
参数
$tag
:过滤器的名字,官方为很多用户有需求修改的参数都设置了过滤器,需要修改某个函数的参数,首先要做的是确定其是否预埋了过滤器,该过滤器的正确名称又是什么;
$value
:用户想要修改(过滤)的参数值,如果用户没有定义过滤函数则值得返回这个值;
$var
:传给过滤函数额外的变量参数,辅助过滤函数对返回值进行操作,可以添加无限个;
返回值:过滤后的值,如果没人过滤则直接返回$value的值。
add_filter()函数的用法
add_filter($tag, $function_to_add, $priority, $accepted_args)
参数
$tag
:(必需)所挂载的过滤器名字(和目标apply_filters()函数的$tag属性一样);
$function_to_add
:(必需)要挂载的回调函数,参考PHP回调函数类型文档;
$priority
:(可选)执行顺序,越小函数越先被执行。默认值:10;
$accepted_args
:(可选)回调函数接收的参数数量,设多个可以接收更多apply_filters()函数传进来的参数。默认值:1
返回值:(布尔)总是True。
动手练习
不传递参数
利用2个空白文件粗暴构建了一个极简的wp主题,在index.php文件里输入如上命令,最后输出结果是“继续伪装”,因为这里的唯一联络人add_filter同志在卧底行动之后才去修改任务,所以错失了良机,所以以上命令应该修改如下,当然实际使用中,我们一般仅需要利用add_filter分配任务,执行顺序是官方考虑的事情。
<?php
function test_function(){
return '身份已泄露,尽快离开。';
}
add_filter('misson','test_function');
echo apply_filters('misson','继续伪装');
?>
传递参数时
<?php
function test_function($var1,$var2,$var3){
return '身份已泄露,尽快离开。'.$var1.'很危险,'.'务必不要去'.$var2.$var3.'。';
}
add_filter('misson','test_function',10,3);
echo apply_filters('misson','继续伪装','九龙','码头');
?>
程序输出结果如下:
身份已泄露,尽快离开。继续伪装很危险,务必不要去九龙码头。
上文add_filter最后的3代表本次传递3个参数,包含允许修改值以及2个辅助参数,如果这里不慎修改为了2,您可能会喜提这样一个错误:
传参的时候用上面的逻辑似乎有点讲不通,恩,可能卧底先在储物箱里放了张纸条:“地区:九龙,地点:码头”,然后在一边旁边若无其事的假装洗澡,一边等联络人查看储物箱,最后才决定下一步行动吧。