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

Copy
1<?php
2
3/**
4 * 与えられたPHPコード文字列を解析し、特定のトークンを検出して出力します。
5 * この関数は、PHPのソースコードが内部的にどのように分解されるかを示し、
6 * T_LOGICAL_AND（論理AND演算子）と T_VARIABLE（変数）の検出に焦点を当てています。
7 *
8 * @param string $code 解析するPHPコード文字列。
9 * @return void
10 */
11function analyzePhpCodeTokens(string $code): void
12{
13    echo "--- PHP コード解析開始 ---\n";
14    echo "対象コード:\n" . $code . "\n\n";
15
16    // token_get_all() 関数は、PHPコードを構文要素（トークン）の配列に分解します。
17    // 各トークンは、その種類（ID）、値（実際の文字列）、行番号を含む配列として返されるか、
18    // または単一文字の演算子（例: '=' や '+'）の場合は文字列として返されます。
19    $tokens = token_get_all($code);
20
21    echo "検出されたトークン:\n";
22    foreach ($tokens as $token) {
23        // トークンが配列形式の場合（多くの意味のあるPHP要素がこれに該当します）
24        if (is_array($token)) {
25            $tokenId = $token[0];    // トークンの内部ID (例: T_VARIABLE は PHP 内部で特定の整数値を持つ定数)
26            $tokenValue = $token[1]; // トークンが表す実際の文字列 (例: '$userName', '&&')
27            $lineNumber = $token[2]; // トークンがコード内で存在する行番号
28
29            // token_name() 関数を使って、トークンIDを人間が読める名前に変換します。
30            $tokenName = token_name($tokenId);
31
32            // T_LOGICAL_AND は、PHPの論理AND演算子 '&&' または 'and' に対応する定数です。
33            if ($tokenId === T_LOGICAL_AND) {
34                echo sprintf(
35                    "  - 行 %d: トークンID %s (論理AND演算子 '%s') を検出しました。\n",
36                    $lineNumber,
37                    $tokenName,
38                    $tokenValue
39                );
40            }
41            // T_VARIABLE は、PHPの変数（例: '$myVariable'）に対応する定数です。
42            elseif ($tokenId === T_VARIABLE) {
43                echo sprintf(
44                    "  - 行 %d: トークンID %s (変数 '%s') を検出しました。\n",
45                    $lineNumber,
46                    $tokenName,
47                    $tokenValue
48                );
49            }
50        }
51    }
52    echo "--- PHP コード解析終了 ---\n";
53}
54
55// 解析対象となるPHPのサンプルコードを定義します。
56// ここには T_LOGICAL_AND と T_VARIABLE の両方が含まれるようにします。
57$samplePhpCode = <<<'EOT'
58<?php
59$userAge = 25;
60$isAdult = true;
61
62// 論理AND演算子 '&&' を使用した条件文です。
63// ここで '$userAge', '$isAdult' は T_VARIABLE、'&&' は T_LOGICAL_AND に対応します。
64if ($userAge >= 18 && $isAdult) {
65    echo "ユーザーは成人です。\n";
66} else {
67    echo "ユーザーは成人ではありません。\n";
68}
69
70$userName = "Alice"; // ここで '$userName' は T_VARIABLE に対応します。
71$hasPermission = false;
72
73// 論理AND演算子 'and' を使用した別の条件文です。
74// ここで '$userName', '$hasPermission' は T_VARIABLE、'and' は T_LOGICAL_AND に対応します。
75if ($userName === "Admin" and $hasPermission) {
76    echo "管理者としてログインしました。\n";
77} else {
78    echo "一般ユーザーとしてログインしました。\n";
79}
80EOT;
81
82// 定義した関数を呼び出し、サンプルコードを解析します。
83analyzePhpCodeTokens($samplePhpCode);
84
85?>

このサンプルコードは、PHPがどのようにコードを解釈しているかの一端を理解するためのものです。具体的には、与えられたPHPのコード文字列を小さな構文要素（トークン）に分解し、その中から特定のトークンを検出して表示する方法を解説しています。

analyzePhpCodeTokens関数は、解析したいPHPコード文字列を引数として受け取ります。この関数は内部でtoken_get_all()関数を使い、PHPコードを構成する個々のトークンの配列に分解します。各トークンは、その種類を示すID、実際の文字列、そしてコード内の行番号といった情報を持っています。

このサンプルコードでは、特にT_LOGICAL_ANDとT_VARIABLEという2種類のトークンに焦点を当てています。T_LOGICAL_ANDは、PHPの論理AND演算子である&&やandに対応するPHP内部の定数です。例えば、「もし条件Aと条件Bが両方とも真ならば」といった状況で使用される部分を指します。一方、T_VARIABLEは、$myVariableのようなPHPの変数名に対応するPHP内部の定数です。

コードは分解されたトークンを順番に確認し、T_LOGICAL_ANDやT_VARIABLEのトークンが検出された場合に、その種類と具体的な値（例：&&や$userAge）をわかりやすく表示します。これにより、PHPがコードをどのように「理解」しているか、すなわち各要素をどのように識別しているかの一端を学ぶことができます。analyzePhpCodeTokens関数の戻り値はvoidであり、解析結果は直接画面に出力されます。この例を通じて、PHPの基本的な文法要素が内部的にどのように処理されているかを、システムエンジニアを目指す初心者の皆様にも直感的に理解していただけます。

Copy
1<?php
2
3/**
4 * PHPコードをトークンに分解し、特定のトークン定数（T_LOGICAL_AND, T_STRING）の出現を検出します。
5 * システムエンジニアを目指す初心者がPHPの内部的な動作を理解するのに役立ちます。
6 *
7 * @param string $code 解析対象のPHPコード文字列
8 */
9function analyzePhpCodeTokens(string $code): void
10{
11    echo "--- PHP コードトークン解析 ---" . PHP_EOL;
12    echo "解析対象コード:" . PHP_EOL;
13    echo "---------------------------" . PHP_EOL;
14    echo $code . PHP_EOL;
15    echo "---------------------------" . PHP_EOL . PHP_EOL;
16
17    // token_get_all() を使用してPHPコードをトークンに分解します。
18    // 各トークンは、配列（[トークンID, 値, 行番号]）または単一文字の文字列として返されます。
19    $tokens = token_get_all($code);
20
21    foreach ($tokens as $token) {
22        if (is_array($token)) {
23            // 配列形式のトークンは、ID, 値, 行番号を含む
24            $tokenId = $token[0];
25            $tokenValue = $token[1];
26            $lineNum = $token[2];
27            
28            // token_name() を使用して、トークンIDを人間が読める名前に変換します。
29            $tokenName = token_name($tokenId);
30
31            echo "  [行: {$lineNum}] トークン名: {$tokenName}, 値: '{$tokenValue}'";
32
33            // T_LOGICAL_AND 定数は、論理AND演算子 '&&' を表します。
34            if ($tokenId === T_LOGICAL_AND) {
35                echo " <-- T_LOGICAL_AND (論理AND演算子 '&&')";
36            } 
37            // T_STRING 定数は、識別子（変数名、関数名、クラス名など）を表します。
38            elseif ($tokenId === T_STRING) {
39                echo " <-- T_STRING (識別子: 変数名、関数名など)";
40            }
41            echo PHP_EOL;
42        } else {
43            // 文字列形式のトークンは、単一の演算子や区切り文字などです。
44            echo "  [文字トークン] 値: '{$token}'" . PHP_EOL;
45        }
46    }
47    echo PHP_EOL . "--- 解析終了 ---" . PHP_EOL;
48}
49
50// 解析対象となるPHPコードの例を定義します。
51$sampleCode = <<<'EOT'
52<?php
53$userAge = 25;
54$isAdult = false;
55
56if ($userAge >= 18 && $userAge <= 65) {
57    $isAdult = true; // ここで T_STRING ($isAdult) と T_LOGICAL_AND (&&) が使われています
58}
59
60if ($isAdult) { // ここで T_STRING ($isAdult) が使われています
61    echo "ユーザーは成人です。";
62} else {
63    echo "ユーザーは成人ではありません。";
64}
65EOT;
66
67// 定義した関数を実行し、サンプルコードを解析します。
68analyzePhpCodeTokens($sampleCode);
69
70?>

このPHPサンプルコードは、与えられたPHPコード文字列をPHPが内部で認識する最小単位である「トークン」に分解し、その種類と値を詳細に表示するものです。analyzePhpCodeTokens関数は、解析したいPHPコードの文字列を引数として受け取り、そのコードをトークン化して結果を画面に出力します。この関数自体は値を返しません。内部ではtoken_get_all()関数が使用され、コードは配列（トークンID、値、行番号を含む）または単一文字の文字列としてトークンに分解されます。このコードでは、T_LOGICAL_AND定数が論理AND演算子&&を、T_STRING定数が変数名や関数名などの識別子を表していることを確認できます。token_name()関数は、内部的なトークンIDを人間が読める名前に変換するのに役立ちます。システムエンジニアを目指す方にとって、PHPがコードをどのように認識し、処理していくのかの基本的な仕組みを理解する一助となります。