解析WordPress中函数钩子hook的作用及基本用法


Posted in PHP onDecember 22, 2015

WordPress 的插件机制实际上只的就是这个 Hook 了,它中文被翻译成钩子,允许你参与 WordPress 核心的运行,是一个非常棒的东西,下面我们来详细了解一下它。
钩子分类

钩子分为两种,一种叫做动作(action),还有一种叫做过滤器(filter)。这两种钩子实现原理基本一样,后边会讲到,使用上的区别在于过滤器有返回值,而动作没有。

动作的理念是让你在一种情况或者一个特别的位置执行一些函数,比如发送一封邮件等;过滤器则是让你修改 WordPress 核心需要用到的一个值,然后 WordPress 再用这些值做一些事情,比如函数的返回值等。

动作钩子

wp_head 是一个很常用的动作钩子,在开发主题过程中,开发者都会在 head 标签里加上 wp_head() 函数,事实上,正是这个函数调用了 wp_head 钩子。

如果插件开发者想要在 head 标签里添加一句话,就可以使用 wp_head 钩子,下边是个简单的例子。

//在 head 标签添加一些内容
function Bing_add_head_tag(){
  echo '添加内容';
}
add_action( 'wp_head', 'Bing_add_head_tag' );

添加代码后,查看前台的网页源代码,就能在 head 标签里看到我们添加的内容了。

解析WordPress中函数钩子hook的作用及基本用法

上边是一个简单的例子,只是打印了一句话。利用这个钩子,我们还可以做一个遇到 404 页面给管理员发送一封邮件的插件,下边简单的写了一个。

//遇到 404 页面给管理员发送邮件
function Bing_404_page_mail(){
  if( !is_404() ) return;//如果不是 404 页面就退出函数
  $to = get_option( 'admin_email' );//获取管理员地址
  $subject = '遇到 404 页面啦!';//邮件标题
  $message = '404 页面的地址:http://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];//邮件内容
  wp_mail( $to, $subject, $message );//发送邮件
}
add_action( 'wp_head', 'Bing_404_page_mail' );

过滤器钩子

根据我的亲身经历,可能过滤器钩子会难理解些,尤其对不熟悉 PHP 的人来说。

过滤器钩子可以让你改一些东西的值,过滤器回调函数会接受一个参数,这就是当前的值。还记得那个用来调用文章内容的 the_content() 函数吧,这个函数就提供了一个 the_content 过滤器。

给 the_content 钩子添加一个函数,这个函数需要接收一个参数,这个参数就是当前的值。

//文章内容全部链接新窗口打开
function Bing_autoblank( $content ){//$content 变量就是文章内容,因为其它过滤器也要过滤,所以这个内容可能是经过其它函数过滤的
  $content = str_replace( '<a', '<a target="_blank"', $content );//添加 target="_blank"
  return $content;//必须要把过滤后的内容返回回去,否则值就丢了
}
add_filter( 'the_content', 'Bing_autoblank' );

钩子原理

事实上,在调用 add_action() 和 add_filter() 的时候,只是向 $wp_filter 全局变量添加了一个数组元素,还要说的就是动作和过滤器是公用的一个全局变量,也就是说,过滤器和动作是不能重名的。

当调用 do_action() 的时候,会查找 $wp_filter 全局变量中都有哪些添加到此动作的函数,循环执行即可。

apply_filters() 比 do_action() 多了一个步奏,就是每次调用函数时还要接收这个函数的返回值,最后把经过多次过滤的值返回出去,供使用。

获取当前钩子列表
WordPress 的动作和过滤器是插件机制的核心部分,允许你在特定的地方主动添加自己需要执行的动作,一般使用 add_action() 和 add_filter() 函数挂载函数。

这些钩子被储存在 $wp_filter 全局变量里,所以,要获取钩子列表,可以直接获取 $wp_filter 全局变量。

<pre><?php var_dump( $GLOBALS['wp_filter'] ); ?></pre>

上边的代码会打印出钩子列表。

解析WordPress中函数钩子hook的作用及基本用法

PHP 相关文章推荐
PHP在XP下IIS和Apache2服务器上的安装
Sep 05 PHP
深思 PHP 数组遍历的差异(array_diff 的实现)
Mar 23 PHP
PHPwind整合最土系统用户同步登录实现方法
Dec 08 PHP
array_multisort实现PHP多维数组排序示例讲解
Jan 04 PHP
php入门学习知识点七 PHP函数的基本应用
Jul 14 PHP
PHP中运用jQuery的Ajax跨域调用实现代码
Feb 21 PHP
深入理解PHP几个算法:PHP冒泡、PHP二分法、PHP求素数、PHP乘法表
Jun 06 PHP
使用php 获取时间今天明天昨天时间戳的详解
Jun 20 PHP
php获取中文拼音首字母类和函数分享
Apr 24 PHP
PHP判断JSON对象是否存在的方法(推荐)
Jul 06 PHP
yii2简单使用less代替css示例
Mar 10 PHP
PHP code 验证码生成类定义和简单使用示例
May 27 PHP
WordPress中使主题支持小工具以及添加插件启用函数
Dec 22 #PHP
配置eAccelerator和XCache扩展来加速PHP程序的执行
Dec 22 #PHP
PHP使用mkdir创建多级目录的方法
Dec 22 #PHP
PHP按指定键值对二维数组进行排序的方法
Dec 22 #PHP
php删除数组中重复元素的方法
Dec 22 #PHP
yii2.0实现验证用户名与邮箱功能
Dec 22 #PHP
PHP内核探索之解释器的执行过程
Dec 22 #PHP
You might like
虫族 Zerg 热键控制
2020/03/14 星际争霸
实现php加速的eAccelerator dll支持文件打包下载
2007/09/30 PHP
PHP+jQuery实现滚屏无刷新动态加载数据功能详解
2017/05/04 PHP
php实现将数据做成json的格式给前端使用
2018/08/21 PHP
PHP匿名函数(闭包函数)详解
2019/03/22 PHP
laravel框架学习笔记之组件化开发实现方法
2020/02/01 PHP
由document.body和document.documentElement想到的
2009/04/13 Javascript
jquery 查找新建元素代码
2010/07/06 Javascript
javascript中的this详解
2014/12/08 Javascript
javascript实现链接单选效果的方法
2015/05/13 Javascript
SublimeText自带格式化代码功能之reindent
2015/12/27 Javascript
理解javascript中的严格模式
2016/02/01 Javascript
结合代码图文讲解JavaScript中的作用域与作用域链
2016/07/05 Javascript
AngularJS ng-change 指令的详解及简单实例
2016/07/30 Javascript
JavaScript中利用构造器函数模拟类的方法
2017/02/16 Javascript
jQuery之动画ajax事件(实例讲解)
2017/07/18 jQuery
如何编写一个完整的Angular4 FormText 组件
2017/11/18 Javascript
详解Angular5 服务端渲染实战
2018/01/04 Javascript
基于vue.js实现的分页
2018/03/13 Javascript
javaScript强制保留两位小数的输入数校验和小数保留问题
2018/05/09 Javascript
js实现星星海特效的示例
2020/09/28 Javascript
jquery实现鼠标悬浮弹出气泡提示框
2020/12/23 jQuery
[43:43]完美世界DOTA2联赛PWL S2 FTD.C vs Rebirth 第一场 11.22
2020/11/24 DOTA
python如何实现excel数据添加到mongodb
2015/07/30 Python
python 将md5转为16字节的方法
2018/05/29 Python
Python字符串的常见操作实例小结
2019/04/08 Python
处理python中多线程与多进程中的数据共享问题
2019/07/28 Python
Tensorflow矩阵运算实例(矩阵相乘,点乘,行/列累加)
2020/02/05 Python
Python读取文件内容为字符串的方法(多种方法详解)
2020/03/04 Python
关于Theano和Tensorflow多GPU使用问题
2020/06/19 Python
详解使用scrapy进行模拟登陆三种方式
2021/02/21 Python
汉米尔顿手表官网:Hamilton
2020/09/13 全球购物
颁奖典礼主持词
2014/03/25 职场文书
2014年监理个人工作总结
2014/12/11 职场文书
工作态度怎么写
2015/06/25 职场文书
2016个人先进事迹材料范文
2016/03/01 职场文书