【PHP8.x】T_FOREACH定数の使い方

T_FOREACH定数の使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2026年03月18日

基本的な使い方

T_FOREACH定数は、PHPのプログラミング言語において、特定のキーワード「foreach」を表す内部的な定数です。この定数は、PHPのソースコードを解析する「字句解析」の過程で使用されます。字句解析とは、人間が書いたプログラムのテキストを、PHPインタープリタが理解できる意味のある最小単位である「トークン」に分解する処理のことです。

例えば、PHPのコード中にforeachという記述があった場合、PHPのパーサはこのforeachという文字列を、T_FOREACHという内部的な定数として識別します。これにより、PHPインタープリタはそれがループ処理を行うためのキーワードであると認識し、適切な処理へと進めることができるのです。

システムエンジニアを目指す初心者の皆さんが普段のプログラミングでこのT_FOREACH定数を直接記述したり利用したりする機会はほとんどありません。しかし、PHPのソースコードを分析するツール、例えばコードフォーマッタや静的解析ツール、あるいはIDE（統合開発環境）のシンタックスハイライト機能などを開発する際には、token_get_all()関数などを利用してPHPコードをトークンに分解し、そのトークンがT_FOREACHであるかどうかを判定するといった形で間接的に利用されることがあります。この定数は、PHPがどのようにコードを解釈し実行しているかという内部的な仕組みを理解する上で重要な要素の一つであり、言語の深い部分を知るための手がかりとなります。

構文(syntax)


1foreach ($iterable_expression as $value) {
2    // statement
3}

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

T_FOREACH は、PHP の字句解析器が foreach キーワードを認識した際に返される整数値です。この定数は、foreach ループの構造を内部的に識別するために使用されます。

サンプルコード

PHP foreach でHTMLテーブルを生成する


1<?php
2
3/**
4 * サンプルデータをHTMLテーブルとして出力します。
5 *
6 * この関数は、PHPの `foreach` ループを使用して配列のデータを反復処理し、
7 * その内容をブラウザで表示できるHTMLテーブルの形式で出力します。
8 *
9 * T_FOREACH 定数について:
10 * T_FOREACH は、PHPの内部で `foreach` キーワードを識別するために使われる
11 * 組み込みのトークン定数です（戻り値の型は int）。
12 * 通常のアプリケーション開発で直接使うことはほとんどありませんが、
13 * PHPコードの構文解析ツールなどを開発する際に利用されます。
14 */
15function renderHtmlTableWithForeach(): void
16{
17    // テーブルに表示するサンプルデータ
18    $users = [
19        ['id' => 1, 'name' => 'Alice', 'email' => 'alice@example.com'],
20        ['id' => 2, 'name' => 'Bob', 'email' => 'bob@example.com'],
21        ['id' => 3, 'name' => 'Charlie', 'email' => 'charlie@example.com'],
22    ];
23
24    // HTMLの出力開始
25    echo "<!DOCTYPE html>\n";
26    echo "<html lang=\"ja\">\n";
27    echo "<head>\n";
28    echo "    <meta charset=\"UTF-8\">\n";
29    echo "    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n";
30    echo "    <title>PHP Foreach Table Example</title>\n";
31    // 簡易的なCSSでテーブルを見やすくする
32    echo "    <style>\n";
33    echo "        body { font-family: Arial, sans-serif; margin: 20px; }\n";
34    echo "        table { width: 80%; border-collapse: collapse; margin-top: 20px; }\n";
35    echo "        th, td { border: 1px solid #ccc; padding: 10px; text-align: left; }\n";
36    echo "        th { background-color: #f2f2f2; }\n";
37    echo "    </style>\n";
38    echo "</head>\n";
39    echo "<body>\n";
40
41    echo "    <h1>ユーザーリスト</h1>\n";
42
43    echo "    <table>\n";
44    echo "        <thead>\n";
45    echo "            <tr>\n";
46    // ヘッダー行を動的に生成
47    if (!empty($users)) {
48        foreach (array_keys($users[0]) as $key) {
49            echo "                <th>" . htmlspecialchars(ucfirst($key)) . "</th>\n";
50        }
51    }
52    echo "            </tr>\n";
53    echo "        </thead>\n";
54    echo "        <tbody>\n";
55
56    // foreach ループを使用して、各ユーザーデータをテーブルの行として出力
57    // この 'foreach' キーワードが、PHP内部では T_FOREACH 定数として識別されます。
58    foreach ($users as $user) {
59        echo "            <tr>\n";
60        foreach ($user as $value) {
61            echo "                <td>" . htmlspecialchars($value) . "</td>\n";
62        }
63        echo "            </tr>\n";
64    }
65
66    echo "        </tbody>\n";
67    echo "    </table>\n";
68
69    // HTMLの出力終了
70    echo "</body>\n";
71    echo "</html>\n";
72}
73
74// 関数を実行してHTMLテーブルを生成します
75renderHtmlTableWithForeach();

このサンプルコードは、PHPのforeachループを使って配列のデータを読み込み、それをブラウザで表示できるHTMLテーブル形式で出力する方法を示しています。まず、ユーザー情報を格納した連想配列$usersを準備します。次に、HTMLの基本的な構造と、テーブルを見やすくするための簡単なCSSを出力します。テーブルのヘッダーは、$users配列の最初の要素のキーをforeachで反復処理して動的に生成しています。そして、foreach ($users as $user)というループを使って、$users配列の各ユーザーデータを1行ずつ取り出し、さらに内側のforeach ($user as $value)で各項目（id, name, email）を取り出してHTMLのセル（<td>）として出力し、最終的にHTMLテーブルを完成させています。

ここで参照されているT_FOREACHは、PHPの内部でforeachキーワードを区別するために用いられる、整数型（int）のトークン定数です。引数はなく、PHPの構文解析など、より低レベルな処理で利用されるもので、通常のアプリケーション開発でこの定数を直接使用することはほとんどありません。このコードの核であるforeachループは、配列やオブジェクトの要素を一つずつ順番に処理するPHPの非常に重要な機能であり、本サンプルではこの機能を使って配列のデータを効率的にHTMLテーブルとして表示しています。

このサンプルコードで登場するT_FOREACH定数は、PHPの内部でforeachキーワードを識別するためのものです。通常のアプリケーション開発では直接利用することはなく、自分でコードに記述する必要はありませんので注意してください。このコードは、配列のデータをforeachループで反復処理し、HTMLテーブルとして出力するPHPの基本的なパターンを示しています。Webページにユーザーデータなどを表示する際には、セキュリティのために必ずhtmlspecialchars()関数を使って内容をエスケープしてください。これにより、クロスサイトスクリプティング（XSS）などの脆弱性を防ぎます。データを安全に表示する方法として、このエスケープ処理を習慣にすることが推奨されます。

PHPコードのトークン解析とT_FOREACH/T_STRING表示


1<?php
2
3/**
4 * PHPコードをトークンに分解し、各トークンの情報と種類を表示する関数。
5 * T_FOREACH および T_STRING トークンを特に強調して表示します。
6 */
7function analyzePhpTokens(): void
8{
9    // 解析対象となるPHPコードの文字列
10    // ここではforeachループと変数の使用例を含めます。
11    $codeToAnalyze = <<<'PHP_CODE'
12<?php
13$data = [1, 2, 3];
14foreach ($data as $item) {
15    echo $item . PHP_EOL; // PHP_EOLはT_STRINGです
16}
17PHP_CODE;
18
19    echo "--- PHP コードトークン解析結果 ---\n";
20
21    // token_get_all() 関数を使用して、PHPコードをトークンの配列に分解します。
22    // 各トークンは、その種類（ID）、値、行番号を含む配列、または単一の文字として返されます。
23    $tokens = token_get_all($codeToAnalyze);
24
25    foreach ($tokens as $token) {
26        if (is_array($token)) {
27            // トークンが配列の場合（例: T_FOREACH, T_STRING など）
28            // token_name() でトークンIDを人間が読める名前に変換します。
29            $tokenName = token_name($token[0]);
30            $tokenValue = $token[1];
31            $tokenLine = $token[2];
32
33            $output = sprintf(
34                "ID: %-20s | Value: '%-15s' | Line: %-4d",
35                $tokenName,
36                $tokenValue,
37                $tokenLine
38            );
39
40            // T_FOREACH 定数は 'foreach' キーワードを表します。
41            if ($token[0] === T_FOREACH) {
42                $output .= " <-- T_FOREACH (foreachキーワード)";
43            }
44            // T_STRING 定数は変数名、関数名、クラス名などの識別子を表します。
45            elseif ($token[0] === T_STRING) {
46                $output .= " <-- T_STRING (識別子やキーワード)";
47            }
48            echo $output . "\n";
49        } else {
50            // トークンが文字列の場合（例: '{', '}', ';', '(' など、単一文字の演算子や区切り文字）
51            echo sprintf("ID: (char)             | Value: '%s'\n", $token);
52        }
53    }
54
55    echo "---------------------------------\n";
56}
57
58// 関数を実行してトークン解析結果を表示します。
59analyzePhpTokens();

このPHPコードは、与えられたPHPのソースコード文字列を、PHPエンジンが解釈する際の最小単位である「トークン」に分解し、その種類と値を表示するものです。主に、token_get_all()関数を使用してPHPコードをトークン配列に変換しています。この関数は、引数としてPHPコードの文字列を受け取り、そのコードを構成するトークンを、トークンID、値、行番号を含む配列、または単一の文字として返します。

サンプルコードでは、特にT_FOREACHとT_STRINGという二つの重要な定数を強調して表示しています。T_FOREACHは、PHPのforeachキーワードを内部的に識別するための整数値の定数です。token_get_all()がforeachというキーワードを検出すると、そのトークンのIDはT_FOREACHの値と一致します。同様に、T_STRINGは、変数名、関数名、クラス名など、ユーザーが定義する識別子や、echoのような特定のキーワードを識別するための定数です。

コードの各トークンが配列として返された場合、その最初の要素（$token[0]）がトークンIDであり、これをT_FOREACHやT_STRINGといった定数と比較することで、特定の種類のトークンを識別し、その意味を詳しく表示しています。これにより、PHPがどのようにコードを構造的に認識しているか、その一端を具体的に理解することができます。

このサンプルコードで示されるT_FOREACHやT_STRINGといった定数は、PHPがコードを内部的に解釈（構文解析）する際に利用するものです。これらは通常のアプリケーション開発で直接使用することはほとんどなく、主にPHPコードの解析ツールや静的解析、あるいは開発におけるデバッグ目的で利用される高度な機能であることを理解しておきましょう。特にT_STRINGは変数名や関数名、クラス名など様々な識別子を指すため、その具体的な意味を特定するには周辺のトークンと合わせて判断する必要があります。token_get_all()関数はコード文字列の構文解析に特化しており、PHPの内部動作を学ぶ上で非常に有用ですが、日常的なコード記述には必要ありません。これらの定数の値はPHPのバージョンによって異なる場合があるため、常に定数名で比較することが推奨されます。