2025年08月11日[月曜日]

the_ID() 関数完全リファレンス

  • 2025/08/07
  • REFERENCE
  • WordPressの関数
  • 0comments
  • 9views
  • 約3分で読めます

WordPressでテーマを作成する際、投稿やページのIDを直接出力するために the_ID() 関数を使用します。この関数は現在のグローバル変数 $post に格納されている投稿の一意のIDを自動的に取得して、そのまま画面に表示します。

基本的な使い方

the_ID() 関数は以下の形で使用します。

the_ID();
PHP

PHPパラメータ

  • なし

戻り値

  • なし(IDを直接出力する)

使用例

the_ID() 関数はパラメータを取りません。常にグローバル変数 $post に格納されている投稿・固定ページのIDを画面に直接表示します。

HTMLの属性値として使用

<div id="post-<?php the_ID(); ?>">
  <!-- 投稿内容 -->
</div>
PHP

CSSクラス名として使用

<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() を適切な場面で使い分けて、より効率的なテーマ作成を行いましょう。

この関数が使われている投稿

この記事の評価をお願いします

評価をすると「既読」となり、まだ読んでいない記事を区別できます。

この投稿をシェアする

コメントを残す

CAPTCHA



STAY CONNECTED

wp-ch Admin

現役のフリーランスエンジニアがWordPressによるWebサイト構築を基礎から実践テクニックまで徹底解説します。

たくさんの方がフォローしてくれています。あなたもぜひ、情報を受け取ってください。

STORY|ストーリー

WordPressを効率よく確実に学ぶためには、学習の順序が大切です。知識が自然に積み上がるよう、学習ステップに沿って記事を順番に並べています。

学習ストーリー第40話まで掲載中

全ストーリーを見る