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源码的钩子机制就会更加如鱼得水。