関数リファレンス/get post

説明

投稿 ID または投稿オブジェクトで指定した投稿のレコードをデータベースから取得します。$output で戻り値の型を指定できます。$filter には、取得したレコード内の各フィールドに対する無害化のコンテキストを指定します。無害化については sanitize_post_field() も見てください。

使い方

<?php get_post( $id, $output, $filter ); ?>

パラメータ

$post

（整数またはオブジェクト） （必須） 取得したい投稿の ID またはオブジェクト。ここには変数を指定してください。例えば 7 のような数値を直接指定するとエラー（Only variables can be passed for reference または Cannot pass parameter 1 by reference）になります。

初期値： なし

$output

（定数） （オプション） 戻り値の型

初期値： OBJECT

• 'ARRAY_A' - 連想配列
• 'ARRAY_N' - インデックス配列
• 'OBJECT' - 投稿オブジェクト

$filter

（文字列） （オプション） 無害化のコンテキスト

初期値： 'raw'

• 'raw' - 数値フィールドの値のみ無害化
• 'edit' - 各種フィルターフックで無害化
• 'db' - 各種フィルターフックで無害化
• 'display' - 数値フィールドの値のみ無害化
• 'attreibute' - esc_attr() で無害化
• 'js' - esc_js() で無害化

用例

投稿 ID が7のタイトルを取得する：

<?php
$my_id = 7;
$post_id_7 = get_post ( $my_id ); 
$title = $post_id_7->post_title;
?>

$output を指定した場合：

<?php
$my_id = 7;
$post_id_7 = get_post( $my_id, ARRAY_A );
$title = $post_id_7['post_title'];
?>

<?php
//	正）投稿 ID としてダミー変数を使用：
$the_post = & get_post( $dummy_id = 7 );
	
//	誤）投稿 ID に数値を使用：
$the_post = & get_post( 7 );
//	Fatal error: 'Only variables can be passed for reference' または 'Cannot pass parameter 1 by reference'
?>

戻り値

戻り値に含まれるフィールドの値： データベース概要 - テーブル： wp_posts も見てください。

ID 

(整数) 投稿 ID

post_author 

(整数) 作成者 ID

post_date 

(文字列) 投稿日時 (YYYY-MM-DD HH:MM:SS)

post_date_gmt 

(文字列) GMT での投稿日時 (YYYY-MM-DD HH:MM:SS)

post_content 

(文字列) 本文

post_title 

(文字列) タイトル

post_category 

(整数) カテゴリー ID。バージョン 2.1 以降、常に0です。投稿のカテゴリーを取得するには get_the_category() を使用してください。

post_excerpt 

(文字列) 抜粋

post_status 

(文字列) 公開ステータス (publish|pending|draft|private|static|object|attachment|inherit|future)

comment_status 

(文字列) コメントステータス (open|closed|registered_only)

ping_status 

(文字列) ピンバック／トラックバックステータス (open|closed)

post_password 

(文字列) 閲覧パスワード

post_name 

(文字列) スラッグ

to_ping 

(文字列) ピン通知 URL

pinged 

(文字列) ピン通知済み URL

post_modified 

(文字列) 更新日時 (YYYY-MM-DD HH:MM:SS)

post_modified_gmt 

(文字列) GMT での更新日時 (YYYY-MM-DD HH:MM:SS)

post_content_filtered 

(文字列)

post_parent 

(整数) 親 ID (固定ページや添付ファイルなどで使用)

guid 

(文字列) 投稿へのリンクの書式になっている識別子。

menu_order 

(整数) 固定ページ の表示順序。

post_type 

(文字列) 投稿タイプ (post|page|attachment)

post_mime_type 

(文字列) 添付ファイルのとき MIME タイプ（image/png など）

comment_count 

(整数) コメント数

変更履歴

• バージョン 1.5.1 : 新規導入

ソースファイル

get_post() は wp-includes/post.php と wp-app.php に含まれています。

関連資料

関数リファレンス、テンプレートタグ目次もご覧ください。

最新英語版： WordPress Codex » Function Reference/get post （最新版との差分）