Wordpress解析系列之PHP编写hook钩子原理简单实例

Wordpress作为全球应用最广泛的个人博客建站工具，有很多的技术架构值得我们学习推敲。其中，最著名最经典的编码技术架构就是采用了hook的机制。

hook翻译成中文是钩子的意思，单独看这个词我们难以理解这个hook机制（即钩子机制）是什么意思。那么笔者就用大白话以通俗易懂方式给大家讲解一下什么是hook机制，以及用原生PHP函数编写实现简单实例。

大白话解释：以Wordpress为例，它的hook机制就是在网页加载时一起加载了很多hook变量，也就是钩子变量，这些变量作用是绑定相关的函数，只要hook变量被加载，Wordpress就会用一个内置通用API函数解析出hook变量包含的函数并执行。好理解吧，一句话就说清楚了hook机制，但是实现并不简单，最关键的就是那个内置API函数解析hook变量。后面笔者先不给大家掰Wordpress源码的hook解析过程了，那个太复杂，考虑的方面很多，学习理解起来比较困难。这里我们采用更简单直接的解说方式，利用原生PHP函数编写个简单的hook机制plugin插件管理类，和大家一起更加直观的理解钩子机制的原理过程。

下面代码的基本过程是：PluginManager内部有hook键值数组_listener()。

1、plugin注册到PluginManager类的包含hook键值的监听数组_listener()中，

2、PluginManager类实例对象调用trigger函数实现加载所有plugin插件并执行功能方法。

 具体过程详见如下代码注释分析：

<?php

// 已注册插件管理核心类
class PluginManager
{
/**
* 监听数组，保存所有已注册插件的类私有的核心数组变量，数组的键名是钩子名，值是对应的插件信息
* @var array private $_listeners
*/
private $_listeners = array();
/**
* 默认构造函数的作用是通过get_active_plugins()读取plugins目录下所有已激活插件信息
* 同时初始化这些插件，注册到核心类PluginManager数组变量$_listeners中
*
* @var array $plugins
* @return void
*/
public function __construct()
{
//这里$plugins数组包含我们获取已激活的所有插件信息,通过get_active_plugins()函数获取具体信息
$plugins = array();
$plugins = $this->get_active_plugins();

if(is_array($plugins) && !empty($plugins) && count($plugins) > 0)
{
foreach($plugins as $plugin)
{
// 约定每个插件类的名字为如下格式，例如DemoActions;
$class = $plugin['name'].'Actions';
if(class_exists($class))
{
//初始实例化已激活插件，$this代表PluginManager实例为参数
new $class($this);
}
}
}
}

/**
* 注册需要监听插件的功能方法绑定到hook钩子，并把hook钩子加入到$_listeners数组
*
* @param string $hook 钩子变量，就是数组的键名，每个钩子可以绑定多个plugin插件类
* @param object $plugin 插件变量，get_class($plugin)获取插件对应的类
* @param string $method 插件$plugin类对应的功能方法
*/
function register($hook, $plugin, $method)
{
//获取插件实现的功能方法
$key = get_class($plugin).'->'.$method;
//echo $key.'<br>'; //这里可以测试$key的值是否是实例方法引用；
//将插件的实例对象和功能方法保存入对应键值为hook名的监听数组中
$this->_listeners[$hook][$key] = array($plugin, $method);
}

/**
* 返回已激活的所有插件名称和路径,读取plugins目录下所有已激活插件信息
*
* @return array() $plugins 返回数组包含每组插件$name:插件名称，也是php文件名；$directory:插件所在路径
*/
function get_active_plugins()
{
$dir = dirname(__FILE__).DIRECTORY_SEPARATOR.'plugins';
$filesnames = scandir($dir);
$plugins = array();
foreach($filesnames as $filename)
{
if($filename!='.' &&$filename!='..')
{
$plugins[] = array(
'name' => strstr($filename,'.', true),
'directory'=>$dir);
}
}
return $plugins;
}

/**
* 触发一个钩子名称下所有的插件自定义功能方法
*
* @param string $hook 钩子的名称
* @param mixed $data 输入钩子内对应插件自定义方法的参数，默认为空
* @return mixed
*/
function trigger($hook, $data='')
{
//查看要实现的钩子，是否在监听数组之中
if (isset($this->_listeners[$hook]) && is_array($this->_listeners[$hook]) && count($this->_listeners[$hook]) > 0)
{
// 循环调用hook钩子所有插件功能方法
foreach ($this->_listeners[$hook] as $listener)
{
// 取出插件实例对象类名
$class = $listener[0];
// 取出插件实例对象自定义的功能方法
$method = $listener[1];
if(method_exists($class,$method))
{
// 动态调用hook钩子下所有插件的功能方法，这里$data为可无的方法参数
$class->$method($data);
}
}
}
}

}

下面的是插件类DemoActions，其解析函数内包含对pluginManager对象的引用，对应的插件文件是Demo.php，该插件自定义功能方法为sayHello()。

// 插件类，约定必须包含固定格式解析函数
class DemoActions
{
/**
* 解析函数的参数是pluginManager类的引用实例
* 函数调用pluginManager实例的register方法注册这个插件
*/
function __construct(&$pluginManager)
{
/* hookdemo参数是钩子的名称
* $this是Demo_actions类的实例
* say_hello参数是此插件的功能方法
*/
$pluginManager->register('hookdemo', $this, 'sayHello');
}

// 这里是自定义的插件功能方法
function sayHello()
{
echo '<br>Hello World<br>';
}
}

实际使用的时候，编辑如下代码程序：

//实际应用程序
$pluginManager = new PluginManager;  //插件管理类实例化对象
$pluginManager->trigger('hookdemo','');  //启动绑定到hookdemo钩子的所有插件功能；

至此，我们就完整的实现了hook钩子绑定插件信息及如何利用hook钩子执行插件自定义功能方法的原理。Wordpress的hook钩子原理与此类似，理解了上面的代码，再逐步深入理解Wordpress源码的钩子机制就会更加如鱼得水。

转自：Wordpress解析系列之PHP编写hook钩子原理简单实例