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