get_post

説明

mixed get_post( [ mixed & int | WP_Post = null, $post [ , string $output = OBJECT [ , string $filter = 'raw' ] ] ] )
任意の投稿情報を取得する。

パラメータ

  • $post
    投稿情報または投稿IDが格納された変数を指定(省略時はnull)。
  • $output
    出力形式(OBJECT、ARRAY_A、ARRAY_Nの何れか)を指定(省略時はOBJECT)。
  • $filter
    フィルターを指定(省略時は'raw')。

返り値

投稿情報が見つかった場合は$outputで指定した形式(オブジェクトまたは配列)で返す。投稿情報が見つからない場合はnullを返す。

注意

パラメータ$postは省略できない。パラメータ$postにnullや0などを指定した場合は、グローバル変数の$GLOBAL['post']を調べ、セットされている場合はその内容を、セットされていない場合はnullを返す。

パラメータ$postだが、どこがのバージョンで投稿IDを変数に入れないとエラーになっていたが、最新版は投稿IDを指定しても問題なくなっている。

パラメータ$outputにARRAY_AまたはARRAY_Nを指定した場合は、固定ページとそれ以外の投稿タイプとでは得られる配列の要素が異なる。具体的には固定ページの場合は'page_template'(ARRAY_Nの場合は25)にテンプレートファイル名が格納されるが、固定ページ以外の場合はこの要素がない。ARRAY_Nを指定してキーが25以降の値を参照するときは注意が必要である。


使用例

  • 投稿IDが10の投稿情報を取得する。
    <?php $post = get_post( 10 $id = 10 ); ?>
  • 投稿IDが10の投稿情報を連想配列で取得する。
    <?php $post = get_post( 10, ARRAY_A ); ?>

フィルター

実行するフィルターはありません。

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/post.php

最終更新 : 2023年06月07日 10:38

関連



お勧め

個人データのエクスポートメール向けに追加された新フィルター(2020年4月2日 更新)

先週「WordPress 5.4 RC3」が公開され、正式リリースまであと1週間。ブロックエディターの機能強化が目立つわけですが、地味な変更点もちらほらと。今回はその中の1つ、「個人データのエクスポート」機能に関連するフィルターを紹介する。

決まった値を返すだけの関数群(2018年5月27日 更新)

WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。

サイドバーの初期化はwidgets_initアクションで(2011年7月14日 更新)

ウィジェットを使ってみたくなり新テーマ「Twenty Eleven」を覗いてみると、codexに記載されていた内容と少し違っている。これって「Twenty Ten」ですでに変更されていたんだね。

Gutenbergでカスタムフィールドを使う(2018年8月10日 更新)

Gutenbergの新エディターではカスタムフィールドのウィジェットが表示されない。既存のカスタムフィールドのデータはなくなるわけでないので、新エディター上で編集・更新できないか調べてみた。

favicon.icoがWordPressロゴになる!?(2020年2月25日 更新)

先週「WordPress 5.4 Beta2」が公開され、来月末には正式リリース。タイミングよく三連休だったので、1つ前の「ニュース」で紹介されていた変更点から確認してみた。