- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細)
関数リファレンス/get post
提供: WordPress Codex 日本語版
投稿 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 (最新版との差分)