• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

関数リファレンス/get post

提供: WordPress Codex 日本語版
< 関数リファレンス
2010年4月29日 (木) 00:04時点におけるKz (トーク | 投稿記録)による版 (全体を和訳)

移動先: 案内検索

投稿 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 
(整数) コメント数

変更履歴

ソースファイル

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



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

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