解析WordPress中函数钩子hook的作用及基本用法
<p>WordPress 的插件机制实际上只的就是这个 Hook 了，它中文被翻译成钩子，允许你参与 WordPress 核心的运行，是一个非常棒的东西，下面我们来详细了解一下它。<br><strong>钩子分类</strong></p>
<p>
钩子分为两种，一种叫做动作（action），还有一种叫做过滤器（filter）。这两种钩子实现原理基本一样，后边会讲到，使用上的区别在于过滤器有返回值，而动作没有。</p>
<p>
动作的理念是让你在一种情况或者一个特别的位置执行一些函数，比如发送一封邮件等；过滤器则是让你修改 WordPress 核心需要用到的一个值，然后 WordPress 再用这些值做一些事情，比如函数的返回值等。</p>
<p>
<strong>动作钩子</strong></p>
<p>
wp_head 是一个很常用的动作钩子，在开发主题过程中，开发者都会在 head 标签里加上 wp_head() 函数，事实上，正是这个函数调用了 wp_head 钩子。</p>
<p>
如果插件开发者想要在 head 标签里添加一句话，就可以使用 wp_head 钩子，下边是个简单的例子。</p>
<div>
<div>
<div id="highlighter_427024">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
<div>
2</div>
<div>
3</div>
<div>
4</div>
<div>
5</div>
</td>
<td>
<div>
<div>
<code>//在 head 标签添加一些内容</code>
</div>
<div>
<code>function</code> <code>Bing_add_head_tag(){</code>
</div>
<div>
<code> </code><code>echo</code> <code>'添加内容'</code><code>;</code>
</div>
<div>
<code>}</code>
</div>
<div>
<code>add_action( </code><code>'wp_head'</code><code>, </code><code>'Bing_add_head_tag'</code> <code>);</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
添加代码后，查看前台的网页源代码，就能在 head 标签里看到我们添加的内容了。</p>
<p>
<img style="max-width:100%!important;height:auto!important;"title="解析WordPress中函数钩子hook的作用及基本用法" alt="解析WordPress中函数钩子hook的作用及基本用法" src="https://zhuji.jb51.net/uploads/img/202305/a9572c7efe94ea970118bbad3c8fd2e3.jpg"></p>
<p>
上边是一个简单的例子，只是打印了一句话。利用这个钩子，我们还可以做一个遇到 404 页面给管理员发送一封邮件的插件，下边简单的写了一个。</p>
<div>
<div>
<div id="highlighter_509040">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
<div>
2</div>
<div>
3</div>
<div>
4</div>
<div>
5</div>
<div>
6</div>
<div>
7</div>
<div>
8</div>
<div>
9</div>
</td>
<td>
<div>
<div>
<code>//遇到 404 页面给管理员发送邮件</code>
</div>
<div>
<code>function</code> <code>Bing_404_page_mail(){</code>
</div>
<div>
<code> </code><code>if</code><code>( !is_404() ) </code><code>return</code><code>;</code><code>//如果不是 404 页面就退出函数</code>
</div>
<div>
<code> </code><code>$to</code> <code>= get_option( </code><code>'admin_email'</code> <code>);</code><code>//获取管理员地址</code>
</div>
<div>
<code> </code><code>$subject</code> <code>= </code><code>'遇到 404 页面啦！'</code><code>;</code><code>//邮件标题</code>
</div>
<div>
<code> </code><code>$message</code> <code>= </code><code>'404 页面的地址：http://'</code> <code>. </code><code>$_SERVER</code><code>[</code><code>'HTTP_HOST'</code><code>] . </code><code>$_SERVER</code><code>[</code><code>'REQUEST_URI'</code><code>];//邮件内容</code>
</div>
<div>
<code> </code><code>wp_mail( </code><code>$to</code><code>, </code><code>$subject</code><code>, </code><code>$message</code> <code>);</code><code>//发送邮件</code>
</div>
<div>
<code>}</code>
</div>
<div>
<code>add_action( </code><code>'wp_head'</code><code>, </code><code>'Bing_404_page_mail'</code> <code>);</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
<strong>过滤器钩子</strong></p>
<p>
根据我的亲身经历，可能过滤器钩子会难理解些，尤其对不熟悉 PHP 的人来说。</p>
<p>
过滤器钩子可以让你改一些东西的值，过滤器回调函数会接受一个参数，这就是当前的值。还记得那个用来调用文章内容的 the_content() 函数吧，这个函数就提供了一个 the_content 过滤器。</p>
<p>
给 the_content 钩子添加一个函数，这个函数需要接收一个参数，这个参数就是当前的值。</p>
<div>
<div>
<div id="highlighter_755131">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
<div>
2</div>
<div>
3</div>
<div>
4</div>
<div>
5</div>
<div>
6</div>
</td>
<td>
<div>
<div>
<code>//文章内容全部链接新窗口打开</code>
</div>
<div>
<code>function</code> <code>Bing_autoblank( </code><code>$content</code> <code>){</code><code>//$content 变量就是文章内容，因为其它过滤器也要过滤，所以这个内容可能是经过其它函数过滤的</code>
</div>
<div>
<code> </code><code>$content</code> <code>= </code><code>str_replace</code><code>( </code><code>'<a'</code><code>, </code><code>'<a target="_blank"'</code><code>, </code><code>$content</code> <code>);</code><code>//添加 target="_blank"</code>
</div>
<div>
<code> </code><code>return</code> <code>$content</code><code>;</code><code>//必须要把过滤后的内容返回回去，否则值就丢了</code>
</div>
<div>
<code>}</code>
</div>
<div>
<code>add_filter( </code><code>'the_content'</code><code>, </code><code>'Bing_autoblank'</code> <code>);</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
<strong>钩子原理</strong></p>
<p>
事实上，在调用 add_action() 和 add_filter() 的时候，只是向 $wp_filter 全局变量添加了一个数组元素，还要说的就是动作和过滤器是公用的一个全局变量，也就是说，过滤器和动作是不能重名的。</p>
<p>
当调用 do_action() 的时候，会查找 $wp_filter 全局变量中都有哪些添加到此动作的函数，循环执行即可。</p>
<p>
apply_filters() 比 do_action() 多了一个步奏，就是每次调用函数时还要接收这个函数的返回值，最后把经过多次过滤的值返回出去，供使用。</p>
<p>
获取当前钩子列表<br>
WordPress 的动作和过滤器是插件机制的核心部分，允许你在特定的地方主动添加自己需要执行的动作，一般使用 add_action() 和 add_filter() 函数挂载函数。</p>
<p>
这些钩子被储存在 $wp_filter 全局变量里，所以，要获取钩子列表，可以直接获取 $wp_filter 全局变量。</p>
<div>
<div>
<div id="highlighter_356157">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
</td>
<td>
<div>
<div>
<code><pre><?php var_dump( </code><code>$GLOBALS</code><code>[</code><code>'wp_filter'</code><code>] ); ?></pre></code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
上边的代码会打印出钩子列表。</p>
<p>
<img style="max-width:100%!important;height:auto!important;"title="解析WordPress中函数钩子hook的作用及基本用法" alt="解析WordPress中函数钩子hook的作用及基本用法" src="https://zhuji.jb51.net/uploads/img/202305/44990254e7384d936d65a9dc52044f08.jpg"></p>
頁:
[1]