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

Copy
1<?php
2
3/**
4 * 指定されたPHPコードを解析し、T_IS_NOT_IDENTICALトークン（`!==`演算子）を検出します。
5 *
6 * T_IS_NOT_IDENTICAL は、PHPの内部パーサーがコードを解析する際に使用するトークン定数の一つで、
7 * 厳密な不一致演算子 `!==` を表します。
8 * この関数は `token_get_all()` を使用してコードをトークンに分解し、
9 * 各トークンの種類と内容を表示します。
10 *
11 * @param string $phpCode 解析対象のPHPコード文字列
12 */
13function analyzeNotIdenticalOperatorToken(string $phpCode): void
14{
15    echo "--- PHPコードの解析を開始 ---\n";
16    echo "解析対象コード:\n" . $phpCode . "\n\n";
17
18    // token_get_all() は '<?php' タグで始まるコードを期待するため、追加します。
19    // PHPコードをトークンの配列に分解します。
20    // 各トークンは、[トークンID, 内容, 行番号] の配列か、単一の文字（オペレータなど）です。
21    $tokens = token_get_all('<?php ' . $phpCode);
22
23    echo "--- 検出されたトークン ---\n";
24    foreach ($tokens as $token) {
25        if (is_array($token)) {
26            // 配列形式のトークン（キーワード、変数、定数など）
27            $tokenId = $token[0];       // トークンの内部ID (例: T_VARIABLE, T_STRING)
28            $tokenContent = $token[1];  // トークンの内容 (例: '$var', 'echo')
29            $lineNumber = $token[2];    // トークンがある行番号
30
31            // token_name() 関数で数値のトークンIDを人間が読める名前に変換します。
32            $tokenName = token_name($tokenId);
33
34            // T_IS_NOT_IDENTICAL トークンを特定し、特別なメッセージを表示します。
35            if ($tokenId === T_IS_NOT_IDENTICAL) {
36                echo "[!] 行 {$lineNumber}: '{$tokenContent}' は T_IS_NOT_IDENTICAL ({$tokenName}) です。\n";
37            } else {
38                echo "    行 {$lineNumber}: '{$tokenContent}' ({$tokenName})\n";
39            }
40        } else {
41            // 単一文字のトークン（`=`, `;`, `{` などの記号やオペレータ）
42            echo "    単一文字トークン: '{$token}'\n";
43        }
44    }
45    echo "--- 解析終了 ---\n";
46}
47
48// サンプルとして、`!==` 演算子を含むPHPコードを定義します。
49$samplePhpCode = <<<CODE
50\$valueA = 10;
51\$valueB = "10";
52\$valueC = 20;
53
54if (\$valueA !== \$valueB) { // ここに T_IS_NOT_IDENTICAL が検出されます
55    echo " \$valueA と \$valueB は厳密には等しくありません。\n";
56}
57
58if (\$valueA === \$valueC) { // T_IS_IDENTICAL
59    echo " \$valueA と \$valueC は厳密に等しいです。\n";
60} else {
61    echo " \$valueA と \$valueC は厳密には等しくありません。\n";
62}
63CODE;
64
65// 関数を実行し、サンプルコードを解析します。
66analyzeNotIdenticalOperatorToken($samplePhpCode);

このサンプルコードは、PHPの内部でコードがどのように解析されるかを示すために、T_IS_NOT_IDENTICALトークン定数を検出する方法を解説しています。T_IS_NOT_IDENTICALは、PHPのパーサー（コードを読み解くプログラム）が、値と型が厳密に異なることを判定する!==演算子を認識したときに使用する内部的なIDです。

analyzeNotIdenticalOperatorToken関数は、引数として渡されたPHPコード文字列を解析対象とします。この関数は、token_get_all()関数を使用してPHPコードを小さな単位である「トークン」の配列に分解します。各トークンは、その種類（例: 変数、文字列、演算子など）、内容、およびコード上の行番号の情報を持っています。関数は戻り値を持ちませんが、解析結果を標準出力に表示します。

コード内のループ処理では、分解されたトークンを一つずつ確認し、token_name()関数でトークンIDを人間が読める名前に変換しています。特に、トークンIDがT_IS_NOT_IDENTICALと一致した場合、そのトークンが厳密な不一致演算子!==であることを特別なメッセージで強調して表示します。これにより、プログラムが!==演算子をどのように認識しているかを視覚的に理解することができます。この解析を通じて、PHPがコードを構成要素に分解し、それぞれの意味を理解する過程を垣間見ることができます。

Copy
1<?php
2
3/**
4 * T_IS_NOT_IDENTICAL 定数（厳密な非等価演算子 '!=='）が
5 * PHPのトークン解析でどのように識別されるかを示すサンプルです。
6 *
7 * システムエンジニアを目指す初心者の方へ：
8 * T_IS_NOT_IDENTICAL は、PHPインタープリタがPHPコードを解析する際に内部的に使用する「トークン」の識別子です。
9 * これは、プログラマーがソースコードで書く「!==」（厳密な非等価演算子）という記号をPHPがどう認識しているかを示します。
10 * 通常のアプリケーション開発で直接この定数を使うことはほとんどありませんが、
11 * PHPがコードをどのように「理解」しているかの一端を学ぶことができます。
12 */
13function demonstrate_t_is_not_identical_token(): void
14{
15    // 厳密な非等価演算子 ' !== ' を含むPHPコードスニペット
16    // この文字列をPHPが内部的にどのように解釈するかを調べます。
17    $code_snippet = '<?php $a = 1; $b = "1"; if ($a !== $b) { echo "厳密には等しくない"; }';
18
19    echo "=== T_IS_NOT_IDENTICAL トークン検出レポート ===\n";
20    echo "以下のPHPコードスニペットを解析します:\n";
21    echo "------------------------------------------------\n";
22    echo $code_snippet . "\n";
23    echo "------------------------------------------------\n\n";
24
25    // token_get_all() 関数は、PHPのソースコードを個々の「トークン」に分解します。
26    // トークンは、変数名、キーワード、演算子など、PHPの最小の文法単位です。
27    $tokens = token_get_all($code_snippet);
28
29    $found = false;
30    foreach ($tokens as $token) {
31        // 各トークンは配列か文字列です。演算子などは通常配列で返されます。
32        if (is_array($token)) {
33            // トークンID (例: 305) を、人間が読める名前 (例: 'T_IS_NOT_IDENTICAL') に変換します。
34            $token_name = token_name($token[0]);
35            
36            // 目的の T_IS_NOT_IDENTICAL トークンを探します。
37            if ($token_name === 'T_IS_NOT_IDENTICAL') {
38                echo "検出: T_IS_NOT_IDENTICAL\n";
39                echo "  値: '" . $token[1] . "' (ソースコード中の ' !== ' の部分)\n";
40                echo "  行: " . $token[2] . "\n\n";
41                $found = true;
42                break; // 最初に見つかったらループを終了します。
43            }
44        }
45    }
46
47    if (!$found) {
48        echo "解析したコードスニペット内では T_IS_NOT_IDENTICAL トークンは見つかりませんでした。\n";
49    }
50
51    echo "===============================================\n\n";
52
53    // 補足: 厳密な非等価演算子 ' !== ' の一般的な使用例
54    echo "=== 厳密な非等価演算子 ' !== ' の実際の動作例 ===\n";
55    echo "この演算子は、値と型が両方とも異なる場合に true を返します。\n";
56    echo "また、値は等しいが型が異なる場合も true を返します。\n\n";
57
58    $value1 = 10;      // 整数型
59    $value2 = "10";    // 文字列型
60    $value3 = 20;      // 整数型
61
62    echo "\$value1 (int: {$value1}) !== \$value2 (string: {$value2}): ";
63    echo ($value1 !== $value2) ? "true (値は同じですが、型が異なるため)\n" : "false (値も型も同じ)\n";
64
65    echo "\$value1 (int: {$value1}) !== \$value1 (int: {$value1}): ";
66    echo ($value1 !== $value1) ? "true (値が異なる)\n" : "false (値も型も同じであるため)\n";
67
68    echo "\$value1 (int: {$value1}) !== \$value3 (int: {$value3}): ";
69    echo ($value1 !== $value3) ? "true (値が異なるため)\n" : "false (値も型も同じ)\n";
70    echo "--------------------------------------------------\n";
71}
72
73// 上記の関数を実行して、結果を確認します。
74demonstrate_t_is_not_identical_token();

T_IS_NOT_IDENTICALは、PHPインタープリタがPHPコードを解析する際に内部的に使用する「トークン」の識別子です。これは、プログラマーがソースコードで記述する厳密な非等価演算子「!==」をPHPが識別するための定数として定義されています。この定数には引数はなく、戻り値もありません。

提示されたサンプルコードでは、token_get_all()関数を使用してPHPのコードスニペットを個々のトークンに分解し、その中からT_IS_NOT_IDENTICALトークンが検出される様子を示しています。これにより、PHPが「!==」という記号をどのように内部的に認識しているかを具体的に確認できます。コード内では、数値10と文字列"10"のように、値は同じでも型が異なる場合に「!==」がtrueとなる厳密な非等価演算子の動作例も示されており、この演算子が値と型の両方を比較することを確認できます。

T_IS_NOT_IDENTICALのようなトークン定数は、通常のPHPアプリケーション開発で直接使用することはほとんどありませんが、PHPの構文解析の仕組みや、PHPがソースコードをどのように解釈し実行しているかという、より深い理解に繋がるものです。