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

Copy
1<?php
2
3/**
4 * PHPコードを解析し、数値として解釈可能な文字列トークンを識別します。
5 *
6 * PHP 8ではT_NUM_STRINGトークンは削除されており、数値として解釈可能な文字列はT_STRINGとして扱われます。
7 * この関数は、token_get_all()で取得したトークンの中から、T_STRINGでありかつis_numeric()で
8 * 数値として判定できるものを「数値として解釈可能な文字列トークン」として識別します。
9 *
10 * @param string $phpCode 解析対象のPHPコード文字列。
11 */
12function analyzeNumericStringTokens(string $phpCode): void
13{
14    // PHPコードをトークンに分解します。
15    $tokens = token_get_all($phpCode);
16
17    foreach ($tokens as $token) {
18        if (is_array($token)) {
19            $tokenName = token_name($token[0]); // トークンIDから名前を取得
20            $tokenValue = $token[1];           // トークンの内容
21            $lineNumber = $token[2];           // トークンがある行番号
22
23            echo "L{$lineNumber}: {$tokenName} ('{$tokenValue}')\n";
24
25            // T_STRINGトークン（一般的な文字列）が数値として解釈可能かを確認します。
26            // PHP 8では、数値のような文字列もT_STRINGとして扱われます。
27            if ($token[0] === T_STRING && is_numeric($tokenValue)) {
28                echo "    -> (数値として解釈可能な文字列トークン)\n";
29            }
30        } else {
31            // 単一文字のトークン（例: ';', '=', '{' など）
32            echo "LNA: 単一文字トークン '{$token}'\n";
33        }
34    }
35}
36
37// 解析対象となるサンプルPHPコード
38$sampleCode = <<<PHP
39<?php
40// バージョン番号を表す文字列リテラル
41\$version = "8.0";
42
43// IDを表す文字列リテラル
44define("APP_ID", "12345");
45
46// 通常の数値リテラル (T_LNUMBERまたはT_DNUMBERとなる)
47\$count = 100;
48
49// 通常の文字列リテラル
50\$name = 'PHP Expert';
51PHP;
52
53// 関数を実行してサンプルコードのトークンを解析し、結果を出力します。
54analyzeNumericStringTokens($sampleCode);

PHPのT_NUM_STRINGは、かつて数値として解釈可能な文字列リテラルを表すトークンでした。しかし、PHP 8ではこのT_NUM_STRINGトークンは削除され、数値のように見える文字列も一般的な文字列トークンであるT_STRINGとして扱われるようになりました。この変更は、PHPのトークン解析の内部的な挙動に影響を与えています。

サンプルコードは、PHP 8以降の環境において、PHPコード内から「数値として解釈可能な文字列」を識別する方法を示しています。analyzeNumericStringTokens関数は、解析対象のPHPコード文字列を引数$phpCodeとして受け取ります。この引数は、解析したいPHPコードの内容を文字列として渡す役割を持ちます。関数は戻り値としてvoidを持ち、処理結果を直接返さず、解析されたトークンの情報と識別結果を標準出力に表示します。

関数内では、まずtoken_get_all()関数を用いてPHPコードを個々のトークンに分解します。その後、各トークンがT_STRINGであるかを確認し、さらにそのトークンの値がis_numeric()関数によって数値として判定可能であるかをチェックします。この二つの条件が満たされた場合に、そのトークンを「数値として解釈可能な文字列トークン」として識別します。これにより、PHP 8で削除されたT_NUM_STRINGの概念を、T_STRINGとis_numeric()を組み合わせることで実現し、例えば"$version = "8.0";"のようなコードから"8.0"がその種別の文字列として特定されます。

Copy
1<?php
2
3/**
4 * 与えられた値を整数に変換するサンプル関数です。
5 * PHPでは、数値のように見える文字列（例: "123", "0xFF"）が内部的に
6 * T_NUM_STRING のようなトークンとして識別されることがあります。
7 * これは、PHPが文字列と数値の比較や算術演算の際に、
8 * 暗黙的に文字列を数値として解釈しようとする挙動に関連します。
9 *
10 * この関数では T_NUM_STRING 定数を直接使用しませんが、
11 * その背景にある「数値のような文字列」の型変換の挙動を示します。
12 *
13 * @param mixed $value 変換対象の値（文字列、数値など）
14 * @return int 変換された整数値。文字列の先頭が数値でない場合は0となります。
15 */
16function convertToIntegerExample(mixed $value): int
17{
18    // PHPで文字列を整数に変換する最も一般的な方法の一つは、(int) キャストです。
19    // このキャストは、文字列の先頭から数値として解釈できる部分を整数に変換します。
20    // もし文字列の先頭が数値として解釈できない場合、結果は 0 となります。
21    $convertedValue = (int) $value;
22
23    echo "元の値: " . var_export($value, true) . " (型: " . gettype($value) . ")" . PHP_EOL;
24    echo "変換後の整数値: " . $convertedValue . " (型: " . gettype($convertedValue) . ")" . PHP_EOL;
25
26    return $convertedValue;
27}
28
29// --- 関数利用例 ---
30echo "--- 文字列や他の型を整数に変換する例 ---" . PHP_EOL;
31
32// 1. 数値のみを含む文字列
33convertToIntegerExample("123");
34echo PHP_EOL;
35
36// 2. 16進数表記の文字列
37// PHPは自動的に16進数を解釈します (0xFF は 255)
38convertToIntegerExample("0xFF");
39echo PHP_EOL;
40
41// 3. 数値で始まるが、その後文字列が続く場合
42// 先頭の数値部分のみが変換されます
43convertToIntegerExample("456abc");
44echo PHP_EOL;
45
46// 4. 純粋な文字列（数値ではない）
47// 数値として解釈できないため 0 になります
48convertToIntegerExample("hello world");
49echo PHP_EOL;
50
51// 5. 既に整数である場合
52convertToIntegerExample(789);
53echo PHP_EOL;
54
55// 6. 浮動小数点数
56// 小数点以下は切り捨てられます
57convertToIntegerExample(123.45);
58echo PHP_EOL;
59
60// --- T_NUM_STRING 定数について ---
61// T_NUM_STRING は、PHPの字句解析フェーズで「数値のように見える文字列リテラル」
62// を識別するために内部的に使用されるトークン定数です。
63// 通常のアプリケーションコードで直接利用することは稀ですが、
64// PHP 8以降で導入され、PHPの内部処理で文字列と数値のより厳密な扱いを助けます。
65if (defined('T_NUM_STRING')) {
66    echo "T_NUM_STRING 定数の値 (PHP内部のトークンID): " . T_NUM_STRING . PHP_EOL;
67}
68?>

このPHPサンプルコードは、PHPにおける文字列から整数への型変換の挙動を、convertToIntegerExample関数を通じて説明しています。T_NUM_STRING定数は、PHPの内部で「数値のように見える文字列リテラル」を識別するために使われるトークン定数であり、このコードでは直接利用しませんが、PHPが文字列を数値として解釈する際の背景を理解するのに役立ちます。

convertToIntegerExample関数は、引数としてmixed型の$valueを受け取り、(int)キャストを用いて整数型に変換した結果をint型で返します。このキャストは、文字列の先頭から数値として解釈できる部分を整数に変換します。例えば、「123」は123に、「0xFF」（16進数）は255に、「456abc」は先頭の「456」のみが変換され456となります。「hello world」のように数値で始まらない文字列は0に変換されます。浮動小数点数も小数点以下が切り捨てられます。これにより、PHPが様々な型の値をどのように整数として解釈するかが確認できます。T_NUM_STRING定数は、PHP 8以降で導入された内部的な識別子であり、字句解析フェーズで利用され、通常のアプリケーションコードで直接使用されることは稀です。