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

Copy
1<?php
2
3/**
4 * 指定されたPHPコードをトークンに分解し、各トークンの詳細を表示します。
5 * T_ELSEおよびT_ENCAPSED_AND_WHITESPACEトークンがどのように現れるかを具体的に示します。
6 *
7 * PHPの内部では、コードはこのような「トークン」の列として解釈されます。
8 * T_ELSEは「else」キーワードを表し、T_ENCAPSED_AND_WHITESPACEはダブルクォート文字列
9 * (例: "Hello, $name!") 内で、変数展開されないテキスト部分や空白を表します。
10 *
11 * @param string $phpCode 分析対象のPHPコード文字列
12 */
13function analyzePhpTokens(string $phpCode): void
14{
15    echo "--- 分析対象のPHPコード ---" . PHP_EOL;
16    echo $phpCode . PHP_EOL;
17    echo "-------------------------" . PHP_EOL . PHP_EOL;
18
19    // token_get_all() 関数は、PHPコードをその構成要素であるトークンに分解します。
20    // 各トークンは、トークンID (整数値)、トークンのテキスト、行番号を含む配列
21    // もしくは、単一文字のトークン (例: '{', '}', ';') の場合はその文字自体、として返されます。
22    $tokens = token_get_all($phpCode);
23
24    echo "--- トークン分析結果 ---" . PHP_EOL;
25    foreach ($tokens as $token) {
26        if (is_array($token)) {
27            // トークンが配列形式の場合（多くのキーワードや識別子、リテラルなど）
28            $tokenName = token_name($token[0]); // トークンID (例: T_ELSEの数値) を文字列名 (例: 'T_ELSE') に変換
29
30            // 特定のトークンが検出された場合に目立つように表示します。
31            $highlight = '';
32            if ($tokenName === 'T_ELSE') {
33                // T_ELSE は 'else' キーワードのトークンです。
34                $highlight = ' <-- リファレンスで指定されたT_ELSE';
35            } elseif ($tokenName === 'T_ENCAPSED_AND_WHITESPACE') {
36                // T_ENCAPSED_AND_WHITESPACE はダブルクォート文字列内の変数展開されない部分です。
37                $highlight = ' <-- キーワードに関連するT_ENCAPSED_AND_WHITESPACE';
38            }
39
40            echo sprintf(
41                "行 %4d: %-30s | 値: '%s'%s",
42                $token[2],                       // トークンが出現する行番号
43                $tokenName,                      // トークンの名前 (例: 'T_IF', 'T_VARIABLE', 'T_ENCAPSED_AND_WHITESPACE')
44                str_replace(["\n", "\r"], ['\n', '\r'], $token[1]), // トークンの実際のテキスト。改行文字は表示用にエスケープ
45                $highlight
46            ) . PHP_EOL;
47        } else {
48            // トークンが単一文字の場合 (例: '{', '}', ';', '=', '.', '(' など)
49            echo sprintf(
50                "行 N/A: %-30s | 値: '%s'",
51                '単一文字トークン',              // トークン名はないため汎用名を指定
52                $token                           // その文字自体
53            ) . PHP_EOL;
54        }
55    }
56    echo "--------------------------" . PHP_EOL;
57}
58
59// 分析対象とするPHPコードを定義します。
60// ダブルクォート文字列内の変数展開と、if-else構造を含めます。
61$sampleCode = <<<'EOD'
62<?php
63$username = "PHP開発者";
64if (true) {
65    echo "こんにちは、{$username}さん！";
66} else {
67    echo "またのご訪問をお待ちしております。";
68}
69EOD;
70
71// 定義したPHPコードを関数に渡し、トークンを分析して表示します。
72analyzePhpTokens($sampleCode);
73

このPHPサンプルコードは、PHPがプログラムコードをどのように内部的に解釈し、構造化しているかを示すものです。PHPは、書かれたコードを「トークン」と呼ばれる最小単位に分解して処理します。

T_ELSEはPHPの内部で定義された定数の一つで、プログラム内のelseキーワードを数値として識別するために使われます。一方、T_ENCAPSED_AND_WHITESPACEは、ダブルクォートで囲まれた文字列（例: "Hello, $name!"）の中で、変数展開される部分以外の固定テキストや空白を識別するためのトークンです。

サンプルコード内のanalyzePhpTokens関数は、引数として渡されたPHPコード文字列を分析します。この関数はtoken_get_all()というPHPの組み込み関数を利用し、コードを個々のトークンに分解します。引数$phpCodeには分析したいPHPコードを文字列として指定し、戻り値voidは関数が結果を直接画面に出力するため何も返さないことを意味します。実行すると、分解された各トークンの種類と、その具体的な値、そして何行目に出現したかを表示します。特に、elseというキーワードがT_ELSEとして、またダブルクォート文字列内の"こんにちは、"や"さん！"といった部分がT_ENCAPSED_AND_WHITESPACEとして検出される様子を具体的に確認できます。これにより、PHPがコードの各要素をどのように認識しているかの基礎を理解できます。

Copy
1<?php
2
3/**
4 * PHPコードを解析し、その構成要素（トークン）を表示する関数。
5 *
6 * この関数は、PHPのソースコードが内部的にどのように小さな部品（トークン）に分解されるかを視覚化します。
7 * 例えば、「else」キーワードはT_ELSEという定数で表されるトークンに、
8 * 変数名や関数名などの識別子（例: $username, echo）はT_STRINGという定数で表されるトークンに
9 * それぞれ対応付けられることが確認できます。
10 *
11 * @param string $phpCode 解析対象のPHPコード文字列
12 * @return void
13 */
14function displayPhpTokens(string $phpCode): void
15{
16    echo "--- 解析対象のPHPコード ---\n";
17    echo $phpCode . "\n";
18    echo "--------------------------\n\n";
19
20    // token_get_all() 関数は、指定されたPHPコードをトークンの配列に分解します。
21    // PHP 8でも利用可能で、コードの構文解析の基礎を理解するのに役立ちます。
22    $tokens = token_get_all($phpCode);
23
24    echo "--- トークン解析結果 ---\n";
25    foreach ($tokens as $token) {
26        if (is_array($token)) {
27            // トークンが配列の場合： [トークンID(整数), トークン内容(文字列), 行番号(整数)] の形式
28            // token_name() 関数は、トークンID（例: 265）をその名前（例: "T_ELSE"）に変換します。
29            $tokenName = token_name($token[0]);
30            $tokenContent = $token[1];
31            $lineNumber = $token[2];
32            echo sprintf(
33                "ID: %-15s | Name: %-15s | Content: \"%s\" (Line: %d)\n",
34                $token[0], $tokenName, $tokenContent, $lineNumber
35            );
36        } else {
37            // トークンが文字列の場合： 単一文字のトークン（例: ';', '{', '}'など）
38            // これらのトークンはそれ自体が内容であるため、IDや名前は持ちません。
39            echo sprintf("ID: N/A           | Name: N/A           | Content: \"%s\"\n", $token);
40        }
41    }
42    echo "--------------------------\n";
43}
44
45// T_ELSEとT_STRINGトークンを含む、PHPの簡単な条件分岐コードの例
46$sampleCode = <<<'EOD'
47<?php
48$userName = "PHP Beginner"; // $userName は T_VARIABLE、"PHP Beginner" は T_CONSTANT_ENCAPSED_STRING
49if (isset($userName)) { // isset と userName は T_STRING
50    echo "Hello, " . $userName . "!"; // echo は T_STRING
51} else { // 'else' は T_ELSE
52    echo "Please provide your name."; // echo は T_STRING
53}
54EOD;
55
56// 上記のサンプルPHPコードを解析し、トークン情報を表示
57displayPhpTokens($sampleCode);

このサンプルコードは、PHPコードが内部的に小さな構成要素（トークン）に分解される様子を視覚化します。displayPhpTokens関数は、引数としてPHPコード文字列を受け取り、token_get_all()関数（PHP 8で利用可能）でそのコードを解析します。token_get_all()は、PHPコード文字列を基に、トークンID（整数）、内容、行番号を含む配列、または単一文字のトークンからなる配列を返します。

リファレンス情報にあるT_ELSEは、elseキーワードがPHPの構文解析器によって識別される際に使用される内部定数で、その値は整数です。このコードではtoken_name()関数がこの整数のIDを「T_ELSE」のような名前に変換して表示します。また、キーワードで指定されたT_STRINGは、echoやissetといった関数名、変数名の一部などの識別子を表すトークンとして識別されます。これらのトークン情報を確認することで、PHPがコードをどのように理解しているかの基礎を学ぶことができます。