本文主要介紹了解析WordPress中函數鉤子hook的作用及基本用法,hook是WordPress中呼叫函數的重要用法,也是外掛程式開發的基礎。希望對大家有幫助。
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 標籤裡看到我們新增的內容了。
上邊是一個簡單的例子,只是印了一句話。利用這個鉤子,我們還可以做一個遇到 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 class="brush:php;toolbar:false"><?php var_dump( $GLOBALS['wp_filter'] ); ?>
上邊的程式碼會印出鉤子清單。
相關推薦:
#WordPress中用於建立以及取得側邊欄的PHP函數實例講解
以上是解析WordPress中hook的使用的詳細內容。更多資訊請關注PHP中文網其他相關文章!