【WordPressの動き方シリーズ】（４）メインクエリができるまで

function wp( $query_vars = '' ) {
    global $wp, $wp_query, $wp_the_query;
    $wp->main( $query_vars );

    if ( ! isset( $wp_the_query ) ) {
        $wp_the_query = $wp_query;
    }
}

public function main( $query_args = '' ) {
    $this->init();
    $this->parse_request( $query_args );
    $this->send_headers();
    $this->query_posts();
    $this->handle_404();
    $this->register_globals();
 
    /**
     * Fires once the WordPress environment has been set up.
     *
     * @since 2.1.0
     *
     * @param WP $this Current WordPress environment instance (passed by reference).
     */
    do_action_ref_array( 'wp', array( &$this ) );
}

public function query_posts() {
    global $wp_the_query;
    $this->build_query_string();
    $wp_the_query->query( $this->query_vars );
}

/**
     * Sets up the WordPress query by parsing query string.
     *
     * @since 1.5.0
     *
     * @param string|array $query URL query string or array of query arguments.
     * @return WP_Post[]|int[] Array of post objects or post IDs.
     */
    public function query( $query ) {
        $this->init();
        $this->query      = wp_parse_args( $query );
        $this->query_vars = $this->query;
        return $this->get_posts();
    }

public function get_posts() {
        global $wpdb;
 
        $this->parse_query();
        //$this->parse_query()で、$this->query_varsの値に応じてis_hogehogの判定で返される値を設定します

        /**
         * Fires after the query variable object is created, but before the actual query is run.
         *
         * Note: If using conditional tags, use the method versions within the passed instance
         * (e.g. $this->is_main_query() instead of is_main_query()). This is because the functions
         * like is_main_query() test against the global $wp_query instance, not the passed one.
         *
         * @since 2.0.0
         *
         * @param WP_Query $this The WP_Query instance (passed by reference).
         */
        do_action_ref_array( 'pre_get_posts', array( &$this ) );
        /*
         pre_get_postsフィルターフックを通じて、WP_Queryのオブジェクト、
　　　　　今回で言うと$wp_the_queryの持つすべてのプロパティに対してフィルターをかける事ができるようになっています。
         また、pre_get_postsフィルターを使い場合には、判定はis_main_query()ではなく、$this->is_main_query()
         （実際は$query->is_main_query()とかになります）を使ってください。
         is_main_query()関数は、改変されたかもしれないメインクエリである$wp_queryを参照し、
　　　　　$this->is_main_query()は改変されていないメインクエリである$wp_the_queryを参照しているからです。
        */
         
         //ここからしばらくSQL文を作るための作業が続くので省略します。

         if ( ! $q['suppress_filters'] ) {
         /*
         ここだけに限りませんが、SQL文におけるWHERE句やJOIN句などに対するフィルターは、
         $q['suppress_filters']の値がfalseの時つまり、クエリ変数にsuppress_filters = falseという項目が無い限り
         fuctions.phpやプラグインでいくらフィルターをかけても有効になりません。
         */
            /**
             * Filters the WHERE clause of the query.
             *
             * @since 1.5.0
             *
             * @param string   $where The WHERE clause of the query.
             * @param WP_Query $this The WP_Query instance (passed by reference).
             */
            $where = apply_filters_ref_array( 'posts_where', array( $where, &$this ) );
 
            /**
             * Filters the JOIN clause of the query.
             *
             * @since 1.5.0
             *
             * @param string   $join  The JOIN clause of the query.
             * @param WP_Query $this The WP_Query instance (passed by reference).
             */
            $join = apply_filters_ref_array( 'posts_join', array( $join, &$this ) );
        }       

        //ここからしばらくSQL文を作るための作業が続くので省略します。

        //データベースからデータを取得した直後
        /*
        データはデータベースから取得した内容を1件ずつオブジェクト形式にし、それを配列として$this->postsに保存しています。
        単純なオブジェクト形式のデータを、WP_Postオブジェクトに変換するのが下のコードです。
        */
        // Convert to WP_Post objects.
        if ( $this->posts ) {
            $this->posts = array_map( 'get_post', $this->posts );
            
        }
        /*
        更に$this->postsの内容をposts_resultsフィルターフックでいじることができます。
        */　
        if ( ! $q['suppress_filters'] ) {
            /**
             * Filters the raw post results array, prior to status checks.
             *
             * @since 2.3.0
             *
             * @param WP_Post[] $posts Array of post objects.
             * @param WP_Query  $this  The WP_Query instance (passed by reference).
             */
            $this->posts = apply_filters_ref_array( 'posts_results', array( $this->posts, &$this ) );
        }
        /*
        また、フィルターフックを通じてデータが追加されたり変更されて、
        それぞれの配列の中身がWP_POSTオブジェクトでなくなると困るので、get_postを使ってWP_POSTでないものはもう一度取得するようにしています。
        */　
        // Ensure that any posts added/modified via one of the filters above are
        // of the type WP_Post and are filtered.
        if ( $this->posts ) {
            $this->post_count = count( $this->posts );
 
            $this->posts = array_map( 'get_post', $this->posts );
 
            if ( $q['cache_results'] ) {
                update_post_caches( $this->posts, $post_type, $q['update_post_term_cache'], $q['update_post_meta_cache'] );
            }
 
            $this->post = reset( $this->posts );
        } else {
            $this->post_count = 0;
            $this->posts      = array();
        } 
        
        //最後に、取得したメインクエリの値を返して終了です。
        return $this->posts;
    }