WordPressの深淵へようこそ。コアコントリビューターとして、日々数千万リクエストを捌くような大規模環境を見ていると、多くのエンジニアが「なぜかサイトが遅い」という壁にぶつかります。
その原因の多くは、実はWordPressの強力すぎる「フックシステム」による意図しないクエリの汚染にあります。今日は、WP_Queryの隠されたスイッチ『`suppress_filters`』を使って、あなたのクエリを「守る」技術を解説します。
—
1. なぜ「勝手に」クエリは改変されるのか？
WordPressには `posts_where` や `posts_join` といった強力なフィルターフックが存在します。これらは、プラグイン開発者が「特定の条件下で記事リストを操作したい」ときに使う魔法の杖です。
しかし、この杖が「望まないタイミング」で振られることが、パフォーマンス低下の最大の要因です。
例えば、あなたが特定のカスタム投稿タイプを高速に取得したいとします。しかし、あなたがインストールしている多言語化プラグインや、アクセス解析プラグインが「全てのクエリに対して、余計なJOIN文やWHERE句」を差し込んできたらどうなるでしょうか？
クエリは複雑になり、MySQLのインデックスは無視され、実行時間は数ミリ秒から数百ミリ秒へ跳ね上がります。
2. suppress_filters：クエリの聖域を守る盾
`suppress_filters` は、WP_Queryの引数に設定する真偽値（boolean）です。これを `true` にすることで、「このクエリに対しては、一切のフィルターフックを適用させない」という強固なバリアを張ることができます。
基本的な使い方
$args = array(
‘post_type’ => ‘product’,
‘posts_per_page’ => 10,
// 聖域の設定：他のプラグインによるクエリ改変をシャットアウトする
‘suppress_filters’ => true,
);
$query = new WP_Query( $args );
この一行を加えるだけで、あなたのクエリは外部からの干渉を受けなくなります。安定した、予測可能なパフォーマンスを手に入れるための「保険」だと考えてください。
—
3. 陥りやすい罠と正しい使い分け
ここで、初学者がよく犯すミスと、プロが考えるべき設計思想を整理しましょう。
Q. 「常に true にすれば最強ではないか？」
いいえ、それは危険です。WordPressの素晴らしいエコシステムの一部を破壊することになります。
- `suppress_filters => false` (デフォルト):
- 多言語化（WPML等）や、権限管理プラグインが動くべき場面では必須です。
- `suppress_filters => true`:
- 「システム的に独立したデータ取得」を行う場合にのみ使用します。例えば、サイドバーの特定ウィジェットや、API経由で取得する純粋なデータセットなどです。
陥りやすい文法エラー
よくあるのが、`get_posts()` と `WP_Query` の混同です。
`get_posts()` は内部で `suppress_filters` がデフォルトで `true` に設定されています。そのため、もしあなたが「プラグインのフィルターを効かせたい」と思っているのに `get_posts()` を使っていると、一生反映されず悩むことになります。
設計の指針：
- 柔軟性が必要なメインループ: `WP_Query` + `suppress_filters => false`
- 高速性・独立性が必要な単発クエリ: `WP_Query` + `suppress_filters => true`
—
4. パフォーマンスを劇的に変える「脳内トレース」
SQLの視点で見てみましょう。`suppress_filters` を有効にすると、MySQLサーバーは以下のようなシンプルなクエリを受け取ります。
— suppress_filters => true の場合
SELECT SQL_CALC_FOUND_ROWS wp_posts.ID FROM wp_posts WHERE post_type = ‘product’ AND post_status = ‘publish’ LIMIT 0, 10;
これがオフだと、プラグインによってはこうなります。
— suppress_filters => false (プラグインが介入した場合の例)
SELECT SQL_CALC_FOUND_ROWS wp_posts.ID FROM wp_posts
INNER JOIN wp_postmeta AS meta1 ON (wp_posts.ID = meta1.post_id)
WHERE post_type = ‘product’ AND post_status = ‘publish’
AND meta1.meta_key = ‘some_plugin_custom_field’ — 意図しないJOIN
LIMIT 0, 10;
この「INNER JOIN」が数万件のテーブルに対して行われるとき、インデックスが最適化されていなければ、DB負荷は激増します。`suppress_filters` を使う判断は、まさに「データベースの設計思想」を制御する行為なのです。
—
最後に：WordPressを掌握するということ
WordPressは「誰でも使える」という顔をしていますが、裏側は非常に複雑なシステムです。しかし、今日学んだ `suppress_filters` のように、コアの挙動を理解し、クエリを制御できるようになれば、もはやあなたは「利用者」ではなく「設計者」です。
ここをクリアしたあなたは、もうプラグインの挙動に振り回されることはありません。自分の意図通りにデータフローを制御できる楽しさを、ぜひ現場の開発で味わってください。
また何か深いレベルの話をしたくなったら、いつでも戻ってきてくださいね。応援しています！