【WordPress】get_posts()とWP_Queryはどちらを使うべき？使い分けを解説

WordPressでカスタムクエリを書く際に必ず登場するのが、get_posts() と WP_Query。

どちらも投稿データを取得するための手段ですが、使い分けを誤ると意図しない結果になってしまうこともあります。

この記事では、それぞれの役割や違い、適切な使い方をわかりやすく解説します。

基本的な違い

項目	get_posts()	WP_Query
返り値	WP_Post オブジェクトの配列	WP_Query オブジェクト
ループ	foreach + setup_postdata()	have_posts() + the_post()
ページネーション	非対応	対応
フィルター（hooks）	無効（suppress_filters = true）	有効（suppress_filters = false）
コードのシンプルさ	シンプル	柔軟だが複雑
拡張性	限定的	高い

get_posts() の特徴と使い方

get_posts() は、投稿を簡易的に取得するための関数です。内部的には WP_Query を使っていますが、suppress_filters が true になっているため、pre_get_posts などのフックが効きません。

使用例

$args = array(
  'post_type' => 'post',
  'posts_per_page' => 5
);
$posts = get_posts($args);

foreach ($posts as $post) {
  setup_postdata($post);
  the_title();
}
wp_reset_postdata();

このように、取得した投稿を foreach で回し、setup_postdata() を通してテンプレートタグを有効にします。

向いているケース

サイドバーやフッターで記事一覧を簡単に出力したい
投稿数が少ない
フックやページネーションを使う必要がない

WP_Query の特徴と使い方

WP_Query は WordPress の投稿取得クラスで、より柔軟かつ強力なカスタマイズが可能です。
ループ構造があり、ページネーションやフィルターの活用もできます。

使用例

$args = array(
  'post_type' => 'post',
  'posts_per_page' => 5
);
$the_query = new WP_Query($args);

if ($the_query->have_posts()) :
  while ($the_query->have_posts()) : $the_query->the_post();
    the_title();
  endwhile;
endif;
wp_reset_postdata();