解析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开发大型项目的一点经验
Oct 09 PHP
解决php中Cannot send session cache limiter 的问题的方法
Apr 27 PHP
PHP 金额数字转换成英文
May 06 PHP
php实现使用正则将文本中的网址转换成链接标签
Dec 03 PHP
php获取访问者IP地址汇总
Apr 24 PHP
微信公众号支付之坑:调用支付jsapi缺少参数 timeStamp等错误解决方法
Jan 12 PHP
ThinkPHP使用Ueditor的方法详解
May 20 PHP
zend framework重定向方法小结
May 28 PHP
微信支付扫码支付php版
Jul 22 PHP
Ajax中的JSON格式与php传输过程全面解析
Nov 14 PHP
实例分析基于PHP微信网页获取用户信息
Nov 24 PHP
基于laravel belongsTo使用详解
Oct 18 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
分享下php5类中三种数据类型的区别
2015/01/26 PHP
php简单实现多维数组排序的方法
2016/09/30 PHP
laravel 实现上传图片到本地和前台访问示例
2019/10/21 PHP
animate动画示例(泪奔的小孩)及stop和delay的使用
2013/05/06 Javascript
自定义ExtJS控件之下拉树和下拉表格附源码
2013/10/15 Javascript
js实现刷新iframe的方法汇总
2015/04/27 Javascript
第二篇Bootstrap起步
2016/06/21 Javascript
vue多级多选菜单组件开发
2020/09/08 Javascript
js实现抽奖效果
2017/03/27 Javascript
ES6学习笔记之正则表达式和字符串正则方法分析
2017/04/25 Javascript
Vue学习笔记进阶篇之函数化组件解析
2017/07/21 Javascript
基于jstree使用AJAX请求获取数据形成树
2017/08/29 Javascript
用vue2.0实现点击选中active其他选项互斥的效果
2018/04/12 Javascript
解决vuex数据异步造成初始化的时候没值报错问题
2019/11/13 Javascript
easyUI 实现的后台分页与前台显示功能示例
2020/06/01 Javascript
js实现盒子滚动动画效果
2020/08/09 Javascript
[01:29]Ti4循环赛第三日精彩回顾
2014/07/13 DOTA
[01:16:16]DOTA2-DPC中国联赛定级赛 RNG vs Phoenix BO3第二场 1月8日
2021/03/11 DOTA
让python 3支持mysqldb的解决方法
2017/02/14 Python
python实现windows壁纸定期更换功能
2019/01/21 Python
Python3 字典dictionary入门基础附实例
2020/02/10 Python
python实现输入三角形边长自动作图求面积案例
2020/04/12 Python
Python 绘制可视化折线图
2020/07/22 Python
pycharm不以pytest方式运行,想要切换回普通模式运行的操作
2020/09/01 Python
如何在Canvas上的图形/图像绑定事件监听的实现
2020/09/16 HTML / CSS
医学专业毕业生个人求职信
2013/12/25 职场文书
党员培训思想汇报
2014/01/07 职场文书
学习雷锋月活动总结
2014/07/03 职场文书
银行职员工作失误检讨书
2014/10/14 职场文书
出国留学自荐信模板
2015/03/06 职场文书
2015年计生工作总结范文
2015/04/24 职场文书
婚宴主持词
2015/06/30 职场文书
奖学金主要事迹范文
2015/11/04 职场文书
辞职信怎么写?
2019/05/21 职场文书
利用Nginx代理如何解决前端跨域问题详析
2021/04/02 Servers
JS数组去重详情
2021/11/07 Javascript