WordPressの深淵へようこそ。
多くの開発者は、`WP_Query`を「記事を取得するための便利な関数」としか認識していません。しかし、データベースの裏側で何が起きているかを知る者にとって、それは「SQLクエリをいかに美しく制御するか」という至高のチューニング対象です。
今日は、WordPress開発者が避けては通れない、そして避けてはいけない「`pre_get_posts`によるクエリ最適化」という武器を授けます。ここをマスターすれば、あなたのサイトは「重いWordPress」から解放されます。
—
1. なぜ「テンプレート内でクエリを書く」のが悪手なのか
多くの初心者がテンプレートファイル（`archive.php`など）で、このように記述してしまいます。
// 悪い例：テンプレートで再クエリを発行している
$query = new WP_Query(array(‘category_name’ => ‘news’));
なぜこれが「罪」なのでしょうか？
理由は、「メインクエリ」と「サブクエリ」の二重発行が発生するからです。WordPressは既にリクエストに応じて必要なデータを取得していますが、わざわざもう一度データベースを叩きに行っているのです。
これを解決するのが、クエリが実行される直前の「魔法のタイミング」である`pre_get_posts`です。
—
2. pre_get_postsの正体：クエリ発行の「検問所」
`pre_get_posts`は、WordPressがSQLを構築し、データベースへ投げに行く直前に割り込むフックです。
イメージとしては、「データベースに向かうSQL文を、直前で握りつぶして書き換える検問所」だと思ってください。
基本的な書き方
add_action(‘pre_get_posts’, ‘my_custom_query_optimization’);
function my_custom_query_optimization($query) {
// 1. 管理画面やメインクエリ以外は無視する
if (is_admin() || !$query->is_main_query()) {
return;
}
// 2. 特定のアーカイブページだけを対象にする
if (is_post_type_archive(‘news’)) {
// 3. 取得件数を変更（SQLのLIMITを書き換える）
$query->set(‘posts_per_page’, 10);
// 4. 不要なJOINを避けるためにフィールドを制限する
// ※これは高度なテクニックですが、WP_Queryの引数で制御可能です
}
}
—
3. 現場で陥りやすい「文法エラー」と「罠」
このフックを使う際、必ず守るべき「鉄の掟」があります。これを守らないとサイト全体がクラッシュします。
① `is_main_query()` のチェック漏れ
これを忘れると、サイドバーのウィジェットやメニューなど、画面上の「あらゆるクエリ」にあなたの改変が適用されてしまいます。結果、意図しない場所で投稿が消えるなどのバグが発生します。必ず入れてください。
② `is_admin()` のチェック漏れ
管理画面の投稿一覧も`WP_Query`で動いています。ここを改変すると、管理者が記事を編集できなくなるという致命的な事態を招きます。
③ クエリの無限ループ（※今回不要ですが注意）
もし`pre_get_posts`の中で`get_posts()`や`new WP_Query()`を呼び出してしまうと、クエリがクエリを呼ぶ無限地獄に陥ります。あくまで「現在の`$query`オブジェクトを操作する」ことに徹してください。
—
4. データベース負荷を減らす：プロのチューニング視点
単に件数を変えるだけではありません。パフォーマンスを極限まで引き上げるには、以下の視点を持ってください。
- 不要なメタデータの取得を抑制する:
`update_post_meta_cache`を`false`に設定することで、`wp_postmeta`テーブルへのJOINをスキップできます。特定のアーカイブでメタデータを使わないなら、これだけでクエリ速度は劇的に向上します。
if (is_post_type_archive(‘news’)) {
$query->set(‘update_post_meta_cache’, false);
$query->set(‘update_post_term_cache’, false);
}
- SQLログを確認する:
[Query Monitor](https://wordpress.org/plugins/query-monitor/) というプラグインを入れてください。`pre_get_posts`で改変した結果、実際に発行されているSQLがどう変わったかを確認する癖をつけてください。これは上級者への必須の登竜門です。
—
最後に：WordPressを掌握するということ
WordPressは「遅い」のではなく、「使い方を知らない者が無駄なクエリを投げ続けている」だけです。
`pre_get_posts`を使いこなし、データベースへの負荷を最小限に抑える技術は、単なるコーディングスキルではなく、「サーバーへの優しさ」です。
ここをクリアすれば、あなたはもうただの「WordPressが使える人」ではありません。「WordPressの仕組みを理解し、最適化できるエンジニア」です。
次のステップとしては、`posts_clauses`フックを使って、SQLの`JOIN`や`WHERE`句を直接ハックする領域へ足を踏み入れてみてください。そこにはさらに広大なパフォーマンスの世界が待っていますよ。
何か分からないことがあれば、いつでも聞いてくださいね。一緒に最高峰を目指しましょう。