WordPressエンジニア向け入門その4、リクエストに応じたデータを取得するメインクエリ処理

2018-03-21 WordPress

WordPressエンジニア向け入門その4です。前回『WordPressエンジニア向け入門その3、リクエスト解析とページ種類の決定』は、WordPressのリクエストの仕組みについて説明しました。今回はその続きで、リクエスト解析結果に基づいたデータ取得処理についてです。

この連載の中でも特に重要な部分です。メインクエリを理解することでWordPressの思想が見えてきます。残念ながら世の中のWordPressの情報で、メインクエリを理解せずに誤ったデータ取得について記載されているものもまだまだ多いです。 確実に理解することで開発の効率化・品質の向上が期待できます。

1 メインクエリとは
2 データ取得処理
3 クエリフラグの設定
4 メインクエリの変更方法
5 まとめ

メインクエリとは

メインクエリとは読んで字のごとく、「メイン」の「クエリ」です。

メインとは、ページで主となるもの（データ）のことです。
クエリとは、データの検索（取得）のことです。

組み合わせると、 ページの主となるデータの検索（取得）処理となります。ページの主となるデータとはなんでしょうか。ページ種類ごとに以下の分類になります。

個別投稿記事ページ → 投稿データ1記事
アーカイブページ → アーカイブに属する投稿データ（通常、複数件）

ページ種類に応じて適切なデータを取得する処理のことをメインクエリといいます。 メインクエリは自動で処理されることもポイントです。

サブクエリとは

メインクエリがあればサブクエリもあります。ページのメインデータではデータを取得・表示する際はサブクエリを実行します。サブクエリは例えば、サイドバーに新着記事5件表示や記事の下部に関連記事を表示する際に利用します。

詳しい処理方法等はまた別の機会に。

データ取得処理

それではメインクエリによるデータ取得処理について説明します。データの取得条件はリクエストの種類（URL）によって変わります。個別投稿記事ページヘのリクエストなのか、アーカイブページへのリクエストなのか等で取得すべきデータが変わるからです。

データ取得処理はWP_Queryというクラスに定義されており、get_posts関数で処理されます。データ取得結果等は$wp_queryというグローバル変数に格納されます。

実際にリクエストからデータを取得する例を見ていきましょう。

例1、カテゴリーアーカイブへのリクエストがあった場合

カテゴリアーカイブページ(http://example.com/category/foo)にリクエストがあった場合、リクエスト解析処理にて、 index.php?category_name=fooというリクエストパラメータと解釈されます。（詳しくは前回の記事『WordPressエンジニア向け入門その3、リクエスト解析とページ種類の決定』をご覧ください）

category=fooというパラメータを元にfooカテゴリに属する投稿記事データを取得します。

例2、個別投稿記事ページへのリクエストがあった場合

パーマリンク設定が、http://example.com/%category%/%postname%/（カテゴリスラッグ/投稿スラッグ）で、個別投稿記事ページ(http://example.com/foo/bar)にリクエストがあった場合（カテゴリ：foo、投稿スラッグ：bar）、リクエスト解析処理にて、 index.php?name=bar&category_name=fooというリクエストパラメータと解釈されます。

name=barのnameパラメータから個別投稿記事へのリクエストと判断し、投稿記事barを取得します。