the_ID() 関数完全リファレンス
- 2025/08/07
- REFERENCE
- WordPressの関数
- 0comments
- 9views
- 約3分で読めます
WordPressでテーマを作成する際、投稿やページのIDを直接出力するために the_ID()
関数を使用します。この関数は現在のグローバル変数 $post
に格納されている投稿の一意のIDを自動的に取得して、そのまま画面に表示します。
目次
基本的な使い方
the_ID()
関数は以下の形で使用します。
the_ID();
PHPPHPパラメータ
- なし
戻り値
- なし(IDを直接出力する)
使用例
the_ID()
関数はパラメータを取りません。常にグローバル変数 $post
に格納されている投稿・固定ページのIDを画面に直接表示します。
HTMLの属性値として使用
<div id="post-<?php the_ID(); ?>">
<!-- 投稿内容 -->
</div>
PHPCSSクラス名として使用
<article class="post-<?php the_ID(); ?>">
<h1><?php the_title(); ?></h1>
<?php the_content(); ?>
</article>
PHP関連関数との違い
get_the_ID() と the_ID() の違い
get_the_ID()
:IDを取得して変数に保存できるthe_ID()
:IDを直接表示する
// get_the_ID()を使用(取得)
$id = get_the_ID();
echo $id;
// the_ID()を使用(直接表示)
the_ID();
// 上記2つは同じ結果になります
123
123
PHP使い分けのポイント
get_the_ID()を使う場面
- IDを変数に格納したい場合
- 条件分岐でIDをチェックしたい場合
- 他の関数のパラメータとしてIDを使いたい場合
the_ID()を使う場面
- HTMLの属性値として直接IDを出力したい場合
- IDをそのまま表示したい場合
// IDを取得して他の処理に使用
$post_id = get_the_ID();
$meta_value = get_post_meta($post_id, 'key', true);
// HTMLの属性値として直接出力
<div id="post-<?php the_ID(); ?>">
<!-- 投稿内容 -->
</div>
PHP注意点
使用できる場面
the_ID()
はグローバル変数 $post
に投稿オブジェクトが格納されている場面で正常に動作します。
- 投稿ページ(single.php):WordPressが自動的に現在表示中の投稿を
$post
に格納 - 固定ページ(page.php):WordPressが自動的に現在表示中の固定ページを
$post
に格納 - ループ内:
the_post()
によって各投稿の$post
オブジェクトが順次設定される
一方、$post
オブジェクトが設定されていない場面では、期待した値が取得できません。
まとめ
the_ID()
関数は WordPressテーマ作成で投稿IDを直接出力したい場合に使用する関数です。
覚えておきたいポイント
the_ID()
はIDを直接出力するため、HTMLの属性値として使用するのが基本- IDを取得するときは
get_the_ID()
、IDを表示するときはthe_ID()
と覚えておけば間違いない - グローバル変数
$post
が設定されている場面で使用する - 使用する機会は
get_the_ID()
と比べて限定的
投稿IDはWordPressで各投稿を識別するための重要な要素です。the_ID()
を適切な場面で使い分けて、より効率的なテーマ作成を行いましょう。