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

Copy
1<?php
2
3/**
4 * 指定されたPHPコード文字列をトークンに分解し、各トークンの詳細を表示します。
5 * 特に T_MINUS_EQUAL と T_VARIABLE トークンを強調します。
6 *
7 * @param string $phpCode 分析するPHPコード文字列。
8 */
9function analyzePhpTokens(string $phpCode): void
10{
11    echo "--- 分析対象のPHPコード ---\n";
12    echo $phpCode;
13    echo "---------------------------\n\n";
14
15    // token_get_all() 関数を使用して、PHPコードをトークンに分解します。
16    // 各トークンは配列 (ID, 値, 行番号) または単一の文字列 (単一文字の演算子など) で構成されます。
17    $tokens = token_get_all($phpCode);
18
19    echo "--- トークン分析結果 ---\n";
20    foreach ($tokens as $token) {
21        if (is_array($token)) {
22            // トークンが配列の場合（多くのPHPキーワード、変数、定数など）
23            $tokenId = $token[0];
24            $tokenValue = $token[1];
25            $tokenLine = $token[2];
26
27            // トークンIDから可読な名前を取得します。
28            $tokenName = token_name($tokenId);
29
30            echo "ID: " . $tokenId . " (" . $tokenName . "), Value: '" . $tokenValue . "', Line: " . $tokenLine . "\n";
31
32            // T_MINUS_EQUAL トークン (リファレンス情報で指定された定数) のチェック
33            if ($tokenId === T_MINUS_EQUAL) {
34                echo "    -> これは '-=' (減算代入) 演算子です。\n";
35            }
36
37            // T_VARIABLE トークン (キーワードで指定された定数) のチェック
38            if ($tokenId === T_VARIABLE) {
39                echo "    -> これは変数です。\n";
40            }
41        } else {
42            // トークンが文字列の場合（'{', '}', ';', '=', など単一文字の演算子や区切り文字）
43            echo "Value: '" . $token . "' (文字列トークン)\n";
44        }
45    }
46    echo "---------------------------\n";
47}
48
49// 分析するPHPコードのサンプルを定義します。
50// T_VARIABLE (変数) と T_MINUS_EQUAL (減算代入演算子) を含んでいます。
51$sampleCode = <<<'PHP_CODE'
52<?php
53$count = 100; // 変数の宣言と初期化 (T_VARIABLE)
54$subtractionValue = 20; // 別の変数 (T_VARIABLE)
55$count -= $subtractionValue; // 減算代入演算子 (T_MINUS_EQUAL) を使用
56echo "現在のカウント: " . $count . "\n";
57PHP_CODE;
58
59// 関数を呼び出してコードのトークンを分析します。
60analyzePhpTokens($sampleCode);

このサンプルコードは、指定されたPHPコード文字列を「トークン」と呼ばれる最小単位に分解し、その詳細情報を表示することで、PHPインタープリタがコードをどのように解釈するかを学ぶためのものです。analyzePhpTokens関数は、引数として分析対象のPHPコード文字列（$phpCode）を受け取ります。この関数は値を返さず（void）、処理結果を直接出力します。

コードの分解にはtoken_get_all()関数が使用され、PHPコードを構成する各要素（キーワード、変数、演算子など）がトークンとして配列に格納されます。各トークンはID（数値）、値（元のコードの一部）、出現行番号といった情報を持っています。

特に、リファレンス情報で指定されたT_MINUS_EQUAL定数は、PHPの減算代入演算子である-=を表す整数値のIDです。また、キーワードとして挙げられたT_VARIABLE定数は、$countのようなPHPの変数を表します。サンプルコードでは、これらの特定のトークンが検出された際に、それがどのような役割を持つ要素であるかを分かりやすく補足説明しています。これにより、PHPの構文が内部的にどのような「部品」で構成されているかを具体的に確認することができます。

Copy
1<?php
2
3/**
4 * PHPソースコードを解析し、そのトークン情報を表示します。
5 * T_MINUS_EQUAL と T_ENCAPSED_AND_WHITESPACE の検出例を含みます。
6 *
7 * システムエンジニアを目指す初心者向けに、PHPの内部的なコード解析の仕組みの一端を示します。
8 */
9function analyzePhpTokens(): void
10{
11    // 解析対象となるPHPコードの例
12    $sourceCode = <<<'EOD'
13<?php
14$totalItems = 100;
15$productName = "Widget";
16
17// T_ENCAPSED_AND_WHITESPACE は、ダブルクォーテーションで囲まれた文字列内で、
18// 変数展開されない部分（静的なテキストや空白）を表すトークンです。
19// 例えば "Hello, " や "! Remaining:" の部分がこれに該当します。
20$statusMessage = "Hello, user! We have $totalItems of $productName remaining.";
21
22// T_MINUS_EQUAL は、複合代入演算子である '-=' を表すトークンです。
23// 例えば、$totalItems -= 10; は $totalItems = $totalItems - 10; と同じ意味です。
24$totalItems -= 10;
25
26echo $statusMessage . " After purchase, " . $totalItems . " items left.\n";
27EOD;
28
29    echo "--- 解析対象のPHPソースコード ---\n";
30    echo $sourceCode;
31    echo "\n----------------------------------\n\n";
32
33    // token_get_all() 関数を使用して、PHPソースコードをトークンの配列に分解します。
34    $tokens = token_get_all($sourceCode);
35
36    echo "--- 検出されたトークンと詳細 ---\n";
37    foreach ($tokens as $token) {
38        if (is_array($token)) {
39            // 配列形式のトークンは、[トークンID, 値, 行番号] を含みます。
40            $tokenName = token_name($token[0]); // トークンIDから名前を取得
41            $tokenValue = str_replace(["\n", "\r"], ['\n', '\r'], $token[1]); // 改行コードを見やすく表示
42
43            printf(
44                "Token: %-30s | Value: '%-30s' | Line: %d\n",
45                $tokenName,
46                $tokenValue,
47                $token[2]
48            );
49
50            // リファレンス情報で指定された T_MINUS_EQUAL の検出
51            if ($token[0] === T_MINUS_EQUAL) {
52                echo "  ^ こちらはリファレンス情報で指定された 'T_MINUS_EQUAL' トークンです (演算子 '-=')\n";
53            }
54            // キーワードで指定された T_ENCAPSED_AND_WHITESPACE の検出
55            if ($token[0] === T_ENCAPSED_AND_WHITESPACE) {
56                echo "  ^ こちらはキーワードで指定された 'T_ENCAPSED_AND_WHITESPACE' トークンです (文字列内の静的な部分)\n";
57            }
58        } else {
59            // 配列ではないトークンは、シングル文字の記号（例: '{', '}', ';', '=', '.', など）です。
60            printf("Token: %-30s | Value: '%-30s' | Line: N/A (シンボル)\n", "SYMBOL", $token);
61        }
62    }
63}
64
65// 関数を実行して、PHPトークン解析のデモンストレーションを行います。
66analyzePhpTokens();
67
68?>

このPHPコードは、PHPのソースコードがどのように内部的に解析され、「トークン」と呼ばれる最小単位に分解されるかを示しています。token_get_all()関数を使用すると、PHPコードがトークンの配列として取得され、それぞれのトークンがどのような意味を持つかを詳細に確認できます。

特に、このコードは二つの重要なトークンの検出に焦点を当てています。一つはT_MINUS_EQUALです。これは複合代入演算子-=を表し、「変数の現在の値から特定の値を引き、その結果を変数に再代入する」という意味を持ちます。このトークンは、PHPの内部では整数値のIDとして識別されます。もう一つはT_ENCAPSED_AND_WHITESPACEです。これは、ダブルクォーテーションで囲まれた文字列内で、変数展開されない静的なテキストや空白部分を表します。例えば"Hello, "や" user!"といった部分がこれに該当し、PHPが文字列リテラルをどのように細かく扱っているかを示しています。

このサンプルは、システムエンジニアを目指す方が、PHPが記述されたコードをどのように「理解」しているか、その内部的な仕組みの一端を学ぶための具体的な例となっています。