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

Copy
1<?php
2
3/**
4 * PHPコードスニペットを解析し、特定のトークン（特にT_NEW）の出現を検出する関数。
5 * この関数は、PHPの内部的なトークン解析メカニズムを、システムエンジニアを目指す初心者にも
6 * わかりやすい形で示します。T_NEWは、クラスの新しいインスタンスを作成する際に使用される
7 * 'new'キーワードを表す定数です。
8 *
9 * @param string $phpCode 解析対象のPHPコード文字列。
10 * @return void
11 */
12function analyzePhpCodeTokens(string $phpCode): void
13{
14    echo "--- PHP コードトークン解析 ---" . PHP_EOL;
15    echo "対象コード:\n" . $phpCode . PHP_EOL . PHP_EOL;
16
17    // token_get_all() はPHPコードをトークンに分割します。
18    // 完全なコードとして解析させるため、先頭に '<?php ' を付加します。
19    // 各トークンは配列 ([トークンID, トークン文字列, 行番号]) または単一の記号文字列です。
20    $tokens = token_get_all('<?php ' . $phpCode);
21
22    foreach ($tokens as $token) {
23        if (is_array($token)) {
24            // トークンID (例: T_NEW) を可読な文字列名に変換します。
25            $tokenName = token_name($token[0]);
26            $tokenValue = $token[1];
27            $tokenLine = $token[2];
28
29            // トークンの詳細情報を出力します。
30            echo "ID: {$tokenName}, 値: '{$tokenValue}', 行: {$tokenLine}" . PHP_EOL;
31
32            // T_NEW定数（'new'キーワード）が検出された場合、特別なメッセージを表示します。
33            if ($token[0] === T_NEW) {
34                echo "    ↑ T_NEW (クラスのインスタンス化に使われる 'new' キーワード) が検出されました！" . PHP_EOL;
35            }
36        } else {
37            // 単一文字のトークン（例: ';', '{', '}' など）を出力します。
38            echo "記号: '{$token}'" . PHP_EOL;
39        }
40    }
41    echo PHP_EOL;
42}
43
44// T_NEW定数（'new'キーワード）を含むPHPのサンプルコード。
45$sampleCode = '
46class SimpleService {
47    public function execute(): string {
48        return "Service executed successfully.";
49    }
50}
51
52// ここで 'new' キーワードを使って SimpleService クラスのインスタンスを作成しています。
53$serviceInstance = new SimpleService();
54echo $serviceInstance->execute();
55';
56
57// 関数を実行して、サンプルコードのトークンを解析します。
58analyzePhpCodeTokens($sampleCode);
59
60?>

このPHPサンプルコードは、PHPがソースコードを内部的に解析し、「new」キーワードを識別する方法を示します。T_NEWは、クラスの新しいインスタンスを作成する際に使用される「new」キーワードを表す、PHPに組み込まれた整数値定数です。

analyzePhpCodeTokens関数は、解析対象のPHPコード文字列を引数として受け取ります。この関数は、PHPの内部関数であるtoken_get_all()を用いて、与えられたPHPコードを意味のある小さな構成要素（トークン）に分解します。分解された各トークンは、T_NEWのようなトークンID、そのトークンが表す実際の文字列、およびコード中の行番号といった情報を含みます。

関数は、これらの分解されたトークンを一つずつ順番に検査し、その詳細を標準出力に表示します。もし現在のトークンのIDがT_NEWと一致した場合、それはコード中に「new」キーワードが出現したことを意味するため、その旨を特別なメッセージで通知します。この関数自体は特定の値を返しません（戻り値はvoid）が、解析の過程と検出結果を画面に出力することで、PHPにおける「new」キーワードの内部処理をシステムエンジニアを目指す初心者にも分かりやすく解説します。