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

Copy
1<?php
2
3/**
4 * T_NAME_FULLY_QUALIFIED 定数の使用例を示す関数。
5 * システムエンジニアを目指す初心者向けに、PHP 8以降で導入された
6 * 完全修飾名を表すトークンを識別する方法を説明します。
7 */
8function demonstrateTNameFullyQualified(): void
9{
10    // T_NAME_FULLY_QUALIFIED 定数の整数値を出力します。
11    // この定数は、PHPのパーサーがコード内の完全修飾名を識別する際に使用するトークンIDです。
12    // PHP 8.0で導入されました。
13    echo "T_NAME_FULLY_QUALIFIED の値: " . T_NAME_FULLY_QUALIFIED . PHP_EOL . PHP_EOL;
14
15    // 完全修飾名（例: \Namespace\Class や \Function\Name）を含むPHPのサンプルコード。
16    $samplePhpCode = <<<'CODE'
17<?php
18
19namespace MyApp;
20
21class MyService
22{
23    public function execute(): void
24    {
25        // ここに完全修飾名が2つあります。
26        $date = new \DateTimeImmutable('now'); // クラスの完全修飾名
27        $formattedDate = $date->format(\DateTimeInterface::RFC3339); // 定数の完全修飾名
28        
29        echo "現在時刻: " . $formattedDate . PHP_EOL;
30    }
31}
32CODE;
33
34    echo "サンプルコードから T_NAME_FULLY_QUALIFIED トークンを検索中:" . PHP_EOL;
35
36    // PHPコードをトークンに分解します。
37    // token_get_all() は、PHPソースコードをPHPの語彙構造要素（トークン）の配列に変換します。
38    $tokens = token_get_all($samplePhpCode);
39
40    // 各トークンを調べ、T_NAME_FULLY_QUALIFIED に一致するものを見つけます。
41    foreach ($tokens as $token) {
42        // トークンは、単一文字の演算子などを示す文字列、
43        // または、トークンID、値、行番号を含む配列のいずれかです。
44        if (is_array($token) && $token[0] === T_NAME_FULLY_QUALIFIED) {
45            echo "  - 発見: T_NAME_FULLY_QUALIFIED" . PHP_EOL;
46            echo "    トークンID: " . $token[0] . " (" . token_name($token[0]) . ")" . PHP_EOL; // IDの人間可読名を返します
47            echo "    トークン値: '" . $token[1] . "'" . PHP_EOL;
48            echo "    行番号: " . $token[2] . PHP_EOL;
49            echo PHP_EOL;
50        }
51    }
52}
53
54// 定数のデモンストレーション関数を実行します。
55demonstrateTNameFullyQualified();
56

T_NAME_FULLY_QUALIFIEDは、PHP 8.0で導入された定数で、PHPのコード内における「完全修飾名」を表すトークンIDです。この定数は引数を取らず、整数型（int）の値を持ちます。PHPの内部処理において、ソースコードを解析するパーサーが、名前空間のルートから始まるクラス名や関数名、定数名などを識別するために利用されます。

サンプルコードでは、まずT_NAME_FULLY_QUALIFIED定数自体の整数値を出力しています。次に、token_get_all()関数を使用してPHPのサンプルコードを構成する要素（トークン）に分解します。分解されたトークンの配列を一つずつ検査し、T_NAME_FULLY_QUALIFIEDに該当するトークンが見つかった場合に、そのトークンの種類、元のコード上の値、および行番号を表示します。これにより、例えば\DateTimeImmutableや\DateTimeInterface::RFC3339のように、名前空間のルートを示す\から始まる完全な名前が、PHPによってどのように認識されているかを具体的に理解することができます。この定数は、コードの静的解析ツールなどを開発する際に役立ちます。

Copy
1<?php
2
3/**
4 * 現在のシステムのホスト名を取得して表示する関数。
5 *
6 * この関数は php_uname('n') を使用して、実行中のシステムのネットワークノード名（ホスト名）を取得します。
7 * 'n' は、php_uname 関数に渡すオプションで、ネットワークノード名を意味します。
8 *
9 * PHPの内部定数 T_NAME_FULLY_QUALIFIED は、完全修飾名（例: \Namespace\ClassName）を
10 * 識別する際のパーサートークンIDとして使用され、その値は整数 (int) ですが、
11 * この関数が取得するシステム情報とは直接関連しません。
12 */
13function displaySystemHostname(): void
14{
15    // php_uname('n') を実行して、現在のシステムのホスト名を取得します。
16    $hostname = php_uname('n');
17
18    // 取得したホスト名を画面に表示します。
19    echo "現在のシステムのホスト名: " . $hostname . "\n";
20}
21
22// displaySystemHostname 関数を実行し、システムのホスト名を表示します。
23displaySystemHostname();

このPHPサンプルコードは、現在実行中のシステムのホスト名を取得し、画面に表示します。

displaySystemHostname関数は引数を受け取らず、戻り値もありません（void）。関数内部ではphp_uname('n')が呼び出されます。この関数はシステム情報を取得し、引数'n'により現在のネットワークノード名（ホスト名）を文字列として返します。取得したホスト名は$hostname変数に格納され、「現在のシステムのホスト名: [ホスト名]」という形式で画面に出力されます。

リファレンス情報にあるT_NAME_FULLY_QUALIFIEDは、PHPの内部で完全修飾名を表すトークンIDとして使われる定数です。引数はなく整数（int）を返しますが、このサンプルコードの動作とは直接関連しません。