query_postsを使わないほうがいい理由
｜WP_Query・pre_get_postsとの違い

まず、どの一覧を変えるコードか確認する

古いテーマや検索で見つけたコードでは、一覧件数を変えるためにquery_posts()が使われていることがあります。最初に、そのコードが投稿一覧やアーカイブのメイン一覧を変えているのか、記事下やサイドバーに別一覧を足しているのかを確認します。

公式リファレンスは、query_posts()がメインクエリを完全に上書きするため、テーマやプラグインでは避けるよう案内しています。

先に、現在のページの一覧を変えたいのか、別枠の一覧を足したいのかを分けます。

メインクエリを後から差し替えると分かりにくくなる

メインクエリと追加のWP_Queryの違いはWP_Queryの役割と使い方で先に整理できます。別ループを作った後の後処理はwp_reset_postdata()が必要な理由へ続けてください。

WordPressはURL、表示設定、カテゴリー、検索語などからメインクエリを先に作ります。query_posts()はテンプレートまで来てからそれを置き換えるため、元のアーカイブ条件やページの文脈が追いにくくなります。

次は古いhome.phpで見かける形です。投稿一覧の件数を変える意図でも、テンプレートからメインクエリを置き換えています。

query_posts( [   'posts_per_page' => 5,] ); if ( have_posts() ) {   echo '<ul>';    while ( have_posts() ) {      the_post();       printf(         '<li><a href="%1$s">%2$s</a></li>',         esc_url( get_permalink() ),         esc_html( get_the_title() )      );   }    echo '</ul>';} wp_reset_query();

最後にwp_reset_query()を書いても、既に実行されたメインクエリとは別に再取得し、置き換える構造は変わりません。ページ送りではpagedも考慮する必要があります。

メインクエリを変えたいならpre_get_postsを使う

メイン一覧を変えるなら、pre_get_postsで実行前のクエリ条件を調整します。

たとえば投稿一覧ページの記事数を5件にしたい場合は、functions.phpなどに次のように書きます。管理画面や別のクエリに影響しないように、is_admin()、query objectのis_main_query()、is_home()で対象を絞ることが大切です。

function wpq_limit_home_posts( $query ) {   if ( is_admin() || ! $query->is_main_query() ) {      return;   }    if ( $query->is_home() ) {      $query->set( 'posts_per_page', 5 );   }}add_action( 'pre_get_posts', 'wpq_limit_home_posts' );

$query->is_main_query()でメインクエリだけを対象にし、is_admin()で管理画面を除外しています。

ここでのis_home()は「投稿一覧ページ」を指し、固定フロントページと常に同じではありません。管理画面の「ホームページの表示」によって対象URLが変わるため、フロントページだけを変えたい場合は要件と条件分岐を見直してください。pre_get_postsの条件を広く書きすぎると、アーカイブや検索結果、feedまで変わることがあります。

別の一覧を追加したいならWP_Queryかget_postsを使う

関連記事やサイドバーの新着など、別枠の一覧ならWP_Queryかget_posts()を使います。メインクエリを変える必要はありません。

get_posts()はWP_Queryの単なる高速版ではありません。少量の投稿配列を受け取る用途に向き、既定の取得件数は5件です。取得後にsetup_postdata()を使ってテンプレートタグの参照先を切り替えた場合は、最後にwp_reset_postdata()が必要です。

次は、現在の記事を除外し、新着3件を別クエリで表示する例です。

$current_post_id = get_queried_object_id(); $related_query = new WP_Query( [   'post_type'           => 'post',   'post_status'         => 'publish',   'posts_per_page'      => 3,   'post__not_in'        => [ $current_post_id ],   'ignore_sticky_posts' => true,] ); if ( $related_query->have_posts() ) {   echo '<ul>';    while ( $related_query->have_posts() ) {      $related_query->the_post();       printf(         '<li><a href="%1$s">%2$s</a></li>',         esc_url( get_permalink() ),         esc_html( get_the_title() )      );   }    echo '</ul>';} else {   echo '<p>表示できる投稿はありませんでした。</p>';} wp_reset_postdata();

$related_queryだけを回し、the_post()を使った後はwp_reset_postdata()で投稿データを戻します。

古いquery_postsコードを見つけた時の置き換え方

古いコードは機械置換せず、メインループ直前なのか、記事下やサイドバーの小さな一覧なのかを確認します。

query_posts()と一緒にあるwp_reset_query()も、WP_Queryのループへ変えた場合はwp_reset_postdata()へ変わることがあります。取得方法と後処理をセットで見直してください。

公式資料で確認したいポイント

公式資料でquery_posts()の注意、pre_get_postsの対象限定、WP_Queryとget_posts()の違いを確認できます。