解析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的面试题集
Nov 19 PHP
php中关于codeigniter的xmlrpc的类在进行数据交换时的类型问题
Jul 03 PHP
ThinkPHP写第一个模块应用
Feb 20 PHP
eaglephp使用微信api接口开发微信框架
Jan 09 PHP
php通过rmdir删除目录的简单用法
Mar 18 PHP
浅谈PHP接收POST数据方式
Jun 05 PHP
PHP读书笔记_运算符详解
Jul 01 PHP
PHP入门教程之面向对象的特性分析(继承,多态,接口,抽象类,抽象方法等)
Sep 11 PHP
YII2框架中使用yii.js实现的post请求
Apr 09 PHP
Yii框架创建cronjob定时任务的方法分析
May 23 PHP
PHP CURL中传递cookie的方法步骤
May 09 PHP
laravel实现上传图片的两种方式小结
Oct 12 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
shopex中集成的站长统计功能的代码简单分析
2011/08/11 PHP
PHP循环语句笔记(foreach,list)
2011/11/29 PHP
PHP之autoload运行机制实例分析
2014/08/28 PHP
Laravel 中获取上一篇和下一篇数据
2015/07/27 PHP
Js切换功能的简单方法
2010/11/23 Javascript
JavaScript中的运算符种类及其规则介绍
2013/09/26 Javascript
JQUERY简单按钮轮换选中效果实现方法
2015/05/07 Javascript
JavaScript事件处理的方式(三种)
2016/04/26 Javascript
AngularJs入门教程之环境搭建+创建应用示例
2016/11/01 Javascript
微信JS-SDK自定义分享功能实例详解【分享给朋友/分享到朋友圈】
2016/11/25 Javascript
JavaScript取得gridview中获取checkbox选中的值
2017/07/24 Javascript
详解Angular6 热加载配置方案
2018/08/18 Javascript
Vue Autocomplete 自动完成功能简单示例
2019/05/25 Javascript
jQuery实现动态加载(按需加载)javascript文件的方法分析
2019/05/31 jQuery
koa2 从入门到精通(小结)
2019/07/23 Javascript
微信小程序wx.getUserInfo授权获取用户信息(头像、昵称)的实现
2020/08/19 Javascript
[03:42]2018完美盛典-《加冕》
2018/12/16 DOTA
[04:03][TI9趣味短片] 小鸽子茶话会
2019/08/20 DOTA
Python中设置变量作为默认值时容易遇到的错误
2015/04/03 Python
在Docker上开始部署Python应用的教程
2015/04/17 Python
python使用opencv驱动摄像头的方法
2018/08/03 Python
Python实现高斯函数的三维显示方法
2018/12/29 Python
Python绘制频率分布直方图的示例
2019/07/08 Python
荷兰男士时尚网上商店:Suitable
2017/12/25 全球购物
Daniel Wellington官方海外旗舰店:丹尼尔惠灵顿DW手表
2018/02/22 全球购物
日本乐天官方海外转运服务:Rakuten Global Express
2018/11/30 全球购物
Onzie官网:美国时尚瑜伽品牌
2019/08/21 全球购物
历史学专业大学生找工作的自我评价
2013/10/16 职场文书
服装设计专业毕业生推荐信
2013/11/09 职场文书
化学教师自荐信范文
2013/12/28 职场文书
大二自我鉴定
2014/01/31 职场文书
税务干部鉴定材料
2014/02/11 职场文书
视光学毕业生自荐书范文
2014/02/13 职场文书
集团公司党的群众路线教育实践活动工作总结
2014/03/03 职场文书
小学生安全责任书
2014/07/25 职场文书
一篇合格的广告文案,其主要目的是什么?
2019/07/12 职场文书