详解WordPress中创建和添加过滤器的相关PHP函数

 更新时间:2015年12月29日 16:28:29   作者:斌果  
这篇文章主要介绍了WordPress中创建和添加过滤器的相关PHP函数,分别是apply_filters()函数和add_filter()函数的使用,需要的朋友可以参考下

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

用法

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

参数

$tag

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

默认值:None

$value

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

$var

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

返回值

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

例子

没人过滤:

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

打印结果:

可以被修改的值

有人过滤:

function test_func(){
  return '修改值';
}
add_filter( 'test', 'test_func' );
echo apply_filters( 'test', '可以被修改的值' );

打印结果:

修改值

接收参数:

function test_func(){
  return '修改值';
}
add_filter( 'test', 'test_func' );
function test_func2( $text ){
  return $text . '2';
}
add_filter( 'test', 'test_func2' );
echo apply_filters( 'test', '可以被修改的值' );

多个参数:

function test_func( $text, $var, $var2 ){
  return '修改值' . $var1 . $var2;
}
add_action( 'test', 'test_func', 10, 3 );
echo apply_filters( 'test', '可以被修改的值', '辅助值1', '辅助值2' );

其它

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

add_filter()(添加过滤器)
add_filter() 可以挂载一个函数到指定的过滤器上。

用法

add_filter( $tag, $function_to_add, $priority, $accepted_args );

参数

$tag

(字符串)(必须)所挂载的过滤器名字(和目标 apply_filters() 函数的 $tag 属性一样)。

默认值:None

$function_to_add

(回调)(必须)要挂载的回调函数,参考 PHP 回调函数类型文档。

默认值:None

$priority

(整数)(可选)执行顺序,越小函数越先被执行。

默认值:10

$accepted_args

(整数)(可选)回调函数接收的参数数量,设置多个可以接收更多 apply_filters() 函数传进来的参数。

默认值:1

返回值

(布尔)总是 True

例子

function test_func( $text, $var1, $var2 ){
  return $text . $var1 . $var2;
}
add_action( 'test', 'test_func', 10, 3 );
echo apply_filters( 'test', '参数2', '参数3', '参数4' );

打印:

test参数2参数3

其它

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

相关文章

  • PHP中Header使用的HTTP协议及常用方法小结

    PHP中Header使用的HTTP协议及常用方法小结

    这篇文章主要介绍了PHP中Header使用的HTTP协议及常用方法,包含了各种错误编码类型及其含义,需要的朋友可以参考下
    2014-11-11
  • php求一个网段开始与结束IP地址的方法

    php求一个网段开始与结束IP地址的方法

    这篇文章主要介绍了php求一个网段开始与结束IP地址的方法,涉及php字符串操作与进制转换的相关技巧,需要的朋友可以参考下
    2015-07-07
  • PHP中HTTP方式下的Gzip压缩传输方法举偶

    PHP中HTTP方式下的Gzip压缩传输方法举偶

    PHP中HTTP方式下的Gzip压缩传输方法举偶...
    2007-02-02
  • php如何获取Http请求

    php如何获取Http请求

    在本篇文章里小编给大家分享的是关于php获取Http请求的方法以及实例代码,需要的朋友们学习下。
    2020-04-04
  • php给数组赋值的实例方法

    php给数组赋值的实例方法

    在本篇文章里小编给各位整理的是关于php如何给数组赋值的相关知识点内容,有需要的朋友们参考下。
    2019-09-09
  • 在ThinkPHP中实现文件上传的实用示例

    在ThinkPHP中实现文件上传的实用示例

    文件上传是现代 Web 应用程序中常见的需求,在 ThinkPHP 框架中,实现文件上传功能相对简单,但仍需注意一些细节,本文将详细介绍如何在 ThinkPHP 中实现文件上传,并提供实用示例,帮助开发者快速上手,需要的朋友可以参考下
    2025-01-01
  • 在PHP中实现Javascript的escape()函数代码

    在PHP中实现Javascript的escape()函数代码

    在 Javascript 中,可以利用 escape/unescape() 和 eval_r() 函数进行简单的转码处理,让普通的 URL 网址看起来比较怪异,使那些令人讨厌的搜索爬虫无法辨认你希望隐藏的资源。
    2010-08-08
  • php实现图片上传并进行替换操作

    php实现图片上传并进行替换操作

    这篇文章主要为大家详细介绍了php实现图片上传并进行替换操作,讲解的很详细,通俗易懂,感兴趣的小伙伴们可以参考一下
    2016-03-03
  • 封装一个PHP可控限速下载文件的方法

    封装一个PHP可控限速下载文件的方法

    这篇文章给大家介绍了封装一个PHP可控限速下载文件的方法,文章通过代码示例介绍的非常详细,对大家的学习或工作有一定的帮助,需要的朋友可以参考下
    2023-10-10
  • PHP图片添加水印功能示例小结

    PHP图片添加水印功能示例小结

    这篇文章主要介绍了PHP图片添加水印功能,结合2个简单实例形式分析了php实现图片添加水印的操作步骤与相关技巧,需要的朋友可以参考下
    2016-10-10

最新评论