flush_rewrite_rules() 函數用來刪除然後根據現有的條件重寫偽靜態規則,也就是刷新一次偽靜態規則了。
先來說一下,通常在主題或者插件添加新的自定義文章類型的時候調用,防止新的自定義文章類型的文章出現 404 的情況,或者很多時候我們都需要在主題啟用的時候執行一些代碼,比如布置一些數據庫表單、跳轉到設置頁面等等,WordPress 本身並沒有提供相關的鉤子,網上也有很多五花八門的實現方法,經過我的研究,發現了可能是最優的方法,下邊分享給大家:
/** *WordPress 在主題啟用的時候執行一些代碼 *http://www.endskin.com/theme-activation-action/ */ function Bing_theme_activation(){ if( $GLOBALS['pagenow'] != 'themes.php' || !isset( $_GET['activated'] ) ) return; /* 這裡就可以放置在主題啟用的時候要執行的代碼了,比如跳轉到設置界面: wp_redirect( admin_url( 'options-general.php' ) );//注意修改頁面地址 die; */ } add_action( 'load-themes.php', 'Bing_theme_activation' );
此代碼放在主題和插件裡都是有效的。
另外要注意,更新偽靜態規則是非常消耗時間和效率的,所以不要每次執行代碼都調用,只在必要的情況調用(比如啟用主題和啟用插件),把 flush_rewrite_rules() 掛到 init 鉤子上是極其不正確的。
用法
flush_rewrite_rules( $hard );
參數
$hard
(布爾)(可選)如果為 True 則一起刷新 .htaccess 文件(hard flush);為 False 則只更新數據庫裡的偽靜態規則(soft flush)。
默認值:True(hard flush)。
例子
在主題啟用的時候更新偽靜態規則:
function Bing_theme_activation(){ if( $GLOBALS['pagenow'] != 'themes.php' || !isset( $_GET['activated'] ) ) return; flush_rewrite_rules(); } add_action( 'load-themes.php', 'Bing_theme_activation' );
在插件啟用的時候更新偽靜態規則:
function Bing_myplugin_activate(){ flush_rewrite_rules(); } register_activation_hook( __FILE__, 'Bing_myplugin_activate' );
其它
此函數位於:wp-includes/rewrite.php