Tweet

Pocket

仕事でWordPressを使用する機会が多くなってきました。
しばらく触っていなかったこともあり、基本的なことを思い出すのにも時間がかかります。

復習をかねて、WordPressがリクエストを処理するフローを簡単にまとめてみようと思います。

WordPressはリクエストを、フロントコントローラーindex.phpで受けて、wp-blog-header.phpを呼び出します。

以下にwp-blog-header.phpのソースコードを記載します。

<?php
if ( ! isset( $wp_did_header ) ) {

    $wp_did_header = true;

    // Load the WordPress library.
    require_once( dirname( __FILE__ ) . '/wp-load.php' ); // 著者注 --- (1)

    // Set up the WordPress query.
    wp(); // 著者注 --- (2)

    // Load the theme template.
    require_once( ABSPATH . WPINC . '/template-loader.php' ); // 著者注 --- (3)

}

wp-blog-header.phpの(1)〜(3)が、WordPressがリクエストを処理する流れを表しています。
(1)〜(3）を順番に見ていきます。

(1) WordPress初期化

wp-load.phpは、WordPressの初期化処理を実行します。
内部でwp-config.phpを読み込みます。さらにwp-config.phpはwp-settings.phpを読み込みます。

wp-settings.phpで初期化処理が実行されます。
具体的には、以下のような処理を実行します。

1. コアファイル読み込み（wp-includes/**）
2. データベース接続
3. デフォルトフィルター（イベントハンドラ）登録
4. プラグイン読み込み
5. グローバル変数 wp_the_query（= wp_query）、wp_rwrite、wpなどを作成（例 $GLOBALS['wp_the_query'] = new WP_Query()）
6. 有効化されているテーマのfunctions.php読み込み（functions.phpが読み込まれた直後に、after_set_up`アクションを実行）
7. initアクションを実行
8. wp-loadアクション実行

(2) wp関数実行 – メインクエリ(WP_Query)構築

wp関数は、パーマリンクからWordPressクエリを取得して、SQLを実行し投稿（WP_Postの配列）をメインクエリ（WP_Queryのインスタンスであるグローバル変数wp_query)のpostsプロパティに格納します。
また発行したクエリ情報は、WP_Query::query_varsに格納されています。

wp関数は、WP::main()を呼び出します。
WP::main()の処理は以下になる

// 著者注 コメント等は削除
class WP {
    // ...
    public function main( $query_args = '' ) {
    $this->init();
    $this->parse_request( $query_args ); // 著者注 --- (a)
    $this->send_headers();
    $this->query_posts(); // 著者注 --- (b)
    $this->handle_404();
    $this->register_globals();

    do_action_ref_array( 'wp', array( &$this ) );
    }
    // ...
}

(a) WP::parse_request()

リクエストをパースして、WordPressクエリ変数(query vars）を、WP_Query::query_varsへ設定します。

(b) WP::query_post()

WP::query_post()は、WP_Query::get_post()を呼び出します。
WP_Query::get_post()は、WP_Query::query_varsからSQLを作成・実行して、結果（WP_Postの配列）をメインクエリWP_Queryのpostsプロパティに格納します。

(3) 表示テンプレートの選択

template-loader.phpは、メインクエリに応じてテンプレートを選択。

備考

投稿タイプクエリを使用できるアクション

クエリタイプ（is_page, is_single, is_categoryなど）を判別できる最初のアクションは、parse_query

WP_Query::get_post()は、WP_Query::parse_query()をコールします。
WP_Query::parse_query()は、クエリタイプをセットします。

class WP_Query {
    // ...

    // 著者注 コメント等削除
    public function get_posts() {
    global $wpdb;

    $this->parse_query(); // --- 著者注 parse_queryメソッドのなかにある parse_queryアクションが投稿クエリタイプを判別可能な最初のアクション

    do_action_ref_array( 'pre_get_posts', array( &$this ) ); // 著者注 --- pre_get_postアクション内では投稿クエリタイプを判別可能

        // ...
    }

    //...
}