この記事は最後に更新してから1年以上経過しています。
説明
get_postsと query_postsは、どちらも複数の投稿情報を取得することができる便利な関数である。パラメータとして指定できる内容も共通しているものが多く、query_postsがより詳細なパラメータを指定でき、高機能になっている。まずは、パラメータで指定できる意味（目的）が同じキーワードを見ていこう。
| 意味 | get_postsのキーワード | query_postsのキーワード |
|---|---|---|
| 取得件数 | numberposts | posts_per_page |
| 取得開始位置 | offset | offset |
| ソート対象 | orderby | orderby |
| ソート順 | order | order |
| 取得する投稿情報ID | include | post__in |
| 除外する投稿情報ID | exclude | post__not_in |
| 投稿情報タイプ | post_type | post_type |
| 取得・除外するカテゴリID | category | cat |
| カスタムフィールドの名前 | meta_key | meta_key |
| カスタムフィールドの値 | meta_value | meta_value |
次に、query_postsにのみ存在する主なキーワードを見てみよう。
| キーワード | 意味 |
|---|---|
| s | 検索文字 |
| category_name | カテゴリ名 |
| tag | 投稿タグのスラッグ |
| author | 投稿者ID |
| author_name | 投稿者名 |
このように、query_postsはget_postsの検索機能を内包し、さらにプラスアルファの検索機能を備えていることを確認できたわけだが、この2つの関数には検索機能のほかに本質的な違いがある。それは、グローバル変数へ影響を及ぼすかどうか。query_postsの検索結果はさまざまなグローバル変数に影響を及ぼすが、get_postsの検索結果にはそういったことがない。
具体的な使い方の違いを少し紹介する。
$posts1 = get_posts( 'category=1' );
$posts2 = query_posts( 'cat=1' );
<?php while ( have_posts() ) : the_post(); ?>
// ここに処理を記述
<php endwhile; ?>
次は、サイドバーに特定のカテゴリの投稿記事の見出しを表示するケース。この場合は、get_postsを使用するほうがいい。
<ul>
<?php
$info_posts = query_posts( 'cat=1' );
foreach ( $info_posts as $info ) {
echo '<li>'.$info->post_title.'</li>';
}
?>
</ul>今度は、キーワード検索で特定のカテゴリのみを検索する場合。こちらは、query_postsを使用するほうがいいだろう。具体的な使い方としては、テーマ内のsearch.phpの冒頭で次のような処理を行えばいい。
<?php
global $query_string;
query_posts( $query_string.'&cat=1,2,3' );
?>
get_postsとquery_postsのおおよその違いはこんな感じだ。
2011/8/1追記：「時代はWP_Queryなのか」も合わせてお読みください。
最終更新 : 2018年05月27日 10:51
関連
お勧め
get_the_post_thumbnail_caption（2018年5月27日 更新）
string get_the_post_thumbnail_caption( mixed $post = null )
投稿ページのサムネイル（アイキャッチ画像）キャプションを取得する。
wp_enqueue_style（2019年11月25日 更新）
void wp_enqueue_style( string $handle [ , string $src = false [ , array $deps = array() [ , string $ver = false [ , string $media = 'all' ] ] ] ] )
使用するスタイルシート（CSS）を出力用のキューに入れる。パラメータ$srcが指定された場合は、グローバル変数$wp_stylesに登録してから出力用のキューに入れる。
post_class（2018年5月27日 更新）
void post_class( [ string $class = '' [ , int $post_id = null ] ] )
投稿情報の種別に応じたクラス属性（class="post-?? post ..."）を表示する。具体的なクラス名は、投稿ID（post-番号）、投稿種別（postやpage）、カテゴリー（category-名前）、タグ（tag-名前）などがある。これらクラス名に合わせたCSSを準備することで、投稿ページのユニークなデザインが表現可能になる。
get_header（2020年8月18日 更新）
void | false get_header( [ string $name = null [ , array $args = array() ] ] )
ヘッダパーツを記述したメインヘッダファイルheader.php（またはサブヘッダファイルheader-???.php）を読み込む。
get_the_excerpt（2018年5月27日 更新）
string get_the_excerpt( [ mixed $post = null$deprecated = '' ] )
投稿情報の抜粋記事を取得する。