WP_Query パラメーターupdate_post_meta_cache

どういう時に使うか

タイトルとURLだけを扱い、投稿メタをまったく読まない軽量な一覧やバッチで false を検討します。

カード内で価格、フラグ、ACFの値などを読むなら、false にしたことで投稿ごとの追加取得が増えることがあります。

永続オブジェクトキャッシュを使う環境では既定の扱いに注記があります。本番と同じ構成で確かめます。

近い引数との違い

update_post_meta_cache は投稿メタ、update_post_term_cache はカテゴリーやタグ、cache_results は投稿情報全体のキャッシュ方針に関わります。

meta_query はメタ条件で投稿を絞る引数です。取得後のメタ先読みを決めるこの引数とは役割が違います。

Builderでの扱い

WP Query Builder では直接指定できますが、表示側でメタを読むか分からない時は既定値を保ちます。

高速化の詳細設定として扱い、false を勧める場合は『この一覧ではメタを使わない』という根拠も表示します。

使いどころ・避けどころと実践確認

取得後に投稿メタを読まない大量処理で、先読みを止める効果を実測できる時に検討します。

カード一覧やテンプレート内でカスタムフィールドを表示する場合は、クエリ回数が増える可能性があるため安易に切りません。

最初の WP_Query だけ速く見えても、後続の get_post_meta() で投稿ごとに追加のデータベース問い合わせが走ることがあるため、画面全体で測ります。

最初の取得だけでなく、カードを描画し終えるまでの問い合わせ回数で判断します。

表示完了までのデータベース問い合わせ回数、処理時間、読んだメタキーを有効・無効で複数回比較します。

実践記事で確認WP_Queryの基本構文と$argsの書き方

WP_Query の取得から表示までを基本構文で固定すると、先読み設定の影響範囲を追えます。

記事を読む →

WordPressの仕様で確認するポイント

公式の Caching Parameters で既定値と用途を確認します。

永続オブジェクトキャッシュ利用時の注記も読み、ローカル環境の結果だけで値を固定しません。

最後は、値を変える目的と、変えた時に失う情報を一緒に確認します。