この記事は最後に更新してから1年以上経過しています。

リクエスト応答を終了する前に何かを処理する

説明

PHPでは、register_shutdown_function関数を使うことでリクエストに対してレスポンスを返した後に何らかの処理を行うことができる。WordPressでもregister_shutdown_function関数は使えると思うのだが、テーマ内のテンプレートでページを表示した後で何かを行う場合はどうすればいいのか、ちょっと調べてみた。

まずWordPressでregister_shutdown_function関数を使っているかを調べてみた。最新(3.6.1現在)のソースコードを眺めると、キャッシュ管理を行うWP_Object_Cacheクラス、データベースアクセス管理を行うwpdbクラス、wp-settings.phpの中でregister_shutdown_function関数を呼び出していることがわかった。

ここで注目したのは、wp-settings.phpの中の呼び出しで、shutdown_action_hookというプライベート関数を登録していた。このshutdown_action_hook関数ではshutdownアクションを実行しており、プラグインや自テーマのfunctions.phpなどで直接register_shutdown_function関数を呼び出すよりも、 add_action関数でshutdownアクション関数を登録するほうがWordPressの行儀にあっているだろう。

add_action( 'shutdown', 'my_shutdown' );
function my_shutdown() {
	// ここに処理内容を記述
}

今回調べたきっかけは、ファイルキャッシュ系のプラグインを作るためだった。実際のところ、リクエスト応答の流れをトレースしてみると、PHPのob_start関数を呼び出してバッファを開始した場合、shutdownアクションが実行される前にob_start関数でバッファされた内容はフラッシュ(出力)されていた。結論として、shutdownアクションの前にバッファされた内容を取得して必要な処理を行わなければならず、最終的にはob_start関数のコールバック関数を指定することで目的は実現できた。

このように羽陽曲折があったわけだが、いつか使う時が来ることを期待してshutdownアクションについてメモっとく。


最終更新 : 2013年09月26日 11:22


お勧め

previous_post_link(2018年5月27日 更新)

void previous_post_link( [ string $format = '« %link' [ , string $link = '%title' [ , bool $in_same_cat$in_same_term = false [ , mixed $excluded_categories$excluded_terms = '' [ , string $taxonomy = 'category' ] ] ] ] ] )
1つ前の投稿ページのリンクを表示する。

is_day(2018年5月27日 更新)

bool is_day( )
要求されているページが、日別アーカイブページ(リクエストURLが/2009/11/30のように、書式が「/年/月/日」の場合)か調べる。

get_previous_posts_link(2014年12月24日 更新)

string get_previous_posts_link( [ string $label = null ] )
前ページ(アーカイブ)へのリンクテキストを取得する。

get_post_custom_values(2013年10月7日 更新)

array get_post_custom_values( [ string $key = '' [ , int $post_id = 0 ] ] )
カスタムフィールドの値を取得する。

add_dashboard_page(2014年12月26日 更新)

mixed add_dashboard_page( string $page_title, string $menu_title, mixed string $capability, string $menu_slug [ , mixed $function = '' ] )
ダッシュボードメニューにサブメニューを登録する。