WP_Query パラメーターupdate_post_term_cache

どういう時に使うか

カテゴリー名やタグ、カスタムタクソノミーを表示しないID取得や内部バッチで false を検討します。

カードにカテゴリーラベルを出すなら、先読みを止めることで投稿ごとの追加取得が増える場合があります。

lazy_load_term_meta とも関係するため、ターム本体とタームメタのどちらを使うかを分けて見ます。

近い引数との違い

update_post_term_cache は投稿とタームの関係、update_post_meta_cache は投稿メタ、lazy_load_term_meta はタームメタの遅延読み込みに関わります。

tax_query はターム条件で取得対象を絞ります。取得後の関連情報を先読みするこの引数とは別の段階です。

Builderでの扱い

WP Query Builder では直接指定できます。カテゴリーやタグを表示するコードも生成する場合は、既定値のままが素直です。

詳細設定に置き、一覧の出力項目を見てから提案値を変えられる設計にします。

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

取得後にカテゴリーやタグを一切読まない大量処理で、ターム先読みを止める効果を計測する時に検討します。

投稿カードへカテゴリーやタグを表示する一覧では、後続読み込みが増える可能性があるため通常は保ちます。

lazy_load_term_meta との関係もあるため、ターム本体とタームメタの読み込みを同じものとして判断しません。

カテゴリーを表示しない一覧では省けても、カードに分類名を出す画面では先読みが役立つ場合があります。

ターム表示あり・なしの処理でデータベース問い合わせ回数、処理時間、キャッシュから読めた回数を指定前後に記録します。

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

標準のループと表示内容を固定し、タームキャッシュ指定だけを変えて比較できます。

記事を読む →

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

公式の Caching Parameters で、投稿ターム情報のキャッシュ引数として確認できます。

永続オブジェクトキャッシュの注記と lazy_load_term_meta の実装上の関係も合わせて確認します。

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