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

Copy
1<?php
2
3/**
4 * PHPコードを解析し、特定のトークン（T_TRY, T_STRING）を識別するサンプル関数。
5 *
6 * この関数はtoken_get_all()を使用してPHPコードをトークンに分解し、
7 * T_TRY ('try'キーワード) と T_STRING (識別子) トークンを特に強調して表示します。
8 * システムエンジニアを目指す初心者にとって、PHPが内部でコードをどのように解釈するかを理解する一助となります。
9 *
10 * @param string $code 解析するPHPコード文字列
11 */
12function analyzePhpTokens(string $code): void
13{
14    echo "--- 解析対象のPHPコード ---\n";
15    echo $code . "\n";
16    echo "--------------------------\n\n";
17
18    // token_get_all() は、PHPスクリプトのソースコードを受け取り、
19    // それをPHPパーサーが使用するトークンの配列に分解します。
20    $tokens = token_get_all($code);
21
22    echo "--- 解析結果 (T_TRY と T_STRING トークンのみ表示) ---\n";
23
24    foreach ($tokens as $token) {
25        // 各トークンは配列（ID, 値, 行番号）または単一の文字（演算子など）です。
26        if (is_array($token)) {
27            $tokenName = token_name($token[0]); // トークンIDを人間が読める名前に変換します。
28
29            // T_TRY は、例外処理ブロックの 'try' キーワードを表す定数です。
30            if ($token[0] === T_TRY) {
31                echo sprintf("トークンID: %-12s | 値: '%s' | 行: %d <- T_TRY (tryキーワード)\n", $tokenName, $token[1], $token[2]);
32            } 
33            // T_STRING は、変数名、関数名、クラス名、メソッド名などの識別子を表す定数です。
34            elseif ($token[0] === T_STRING) {
35                echo sprintf("トークンID: %-12s | 値: '%s' | 行: %d <- T_STRING (識別子)\n", $tokenName, $token[1], $token[2]);
36            }
37            // その他のトークンはここでは表示しないことで、出力を簡潔に保ちます。
38        }
39    }
40    echo "-----------------------------------------------------\n";
41}
42
43// 解析対象となるPHPコードの例を定義します。
44// T_TRY と T_STRING の両方が含まれるように記述しています。
45$sampleCode = <<<'PHP_CODE'
46<?php
47
48class CustomError extends Exception {}
49
50function performOperation(int $value): void
51{
52    try {
53        if ($value < 0) {
54            throw new CustomError("負の値は許可されません。");
55        }
56        echo "処理が成功しました: " . $value . "\n";
57    } catch (CustomError $e) {
58        echo "エラー発生: " . $e->getMessage() . "\n";
59    } finally {
60        echo "操作を終了します。\n";
61    }
62}
63
64performOperation(10);
65performOperation(-5);
66
67PHP_CODE;
68
69// 定義したPHPコードを解析関数に渡し、結果を表示します。
70analyzePhpTokens($sampleCode);

PHP 8におけるT_TRYとT_STRINGは、PHPの内部的な挙動を示す「定数」です。T_TRYは、例外処理ブロックの開始を示すtryキーワードをPHPのパーサーが識別する際に使用されます。一方、T_STRINGは、プログラム内で使われる変数名、関数名、クラス名、メソッド名といった識別子（プログラマーが定義する名前）を識別するために用いられます。これらの定数自体には引数や戻り値はありません。

提供されたサンプルコードのanalyzePhpTokens関数は、指定されたPHPコード文字列を引数として受け取り、token_get_all()関数を使ってコードを構成する各要素（トークン）に分解します。その後、分解されたトークンの中からT_TRYとT_STRINGに該当するものを抽出し、その種類、値、行番号を表示します。この関数は解析結果を出力するだけで、特定の値を戻り値として返しません。このサンプルは、PHPがソースコードをどのように解釈し、プログラムの構造を認識しているかを知る良い機会となり、システムエンジニアを目指す初心者が言語の内部動作を理解する一助となります。

Copy
1<?php
2
3/**
4 * PHPのtry-catch-finallyブロックの基本的な使い方をデモンストレーションします。
5 *
6 * システムエンジニアを目指す初心者向けに、例外処理の仕組みを簡潔に示します。
7 * 'try'キーワードは、例外が発生する可能性のあるコードを囲み、
8 * プログラムのクラッシュを防ぎ、エラーを適切に処理するために使用されます。
9 */
10function demonstrateTryCatchFinally(): void
11{
12    echo "--- ケース1: 例外が発生しない場合 ---\n";
13    try {
14        // 例外が発生する可能性のあるコードを記述します
15        echo "tryブロック: 処理を開始します。\n";
16        $numerator = 10;
17        $denominator = 2;
18        $result = $numerator / $denominator;
19        echo "tryブロック: 処理が成功しました。結果: " . $result . "\n";
20    } catch (Exception $e) {
21        // tryブロック内で例外が発生した場合に実行されます
22        echo "catchブロック: 例外を捕捉しました: " . $e->getMessage() . "\n";
23    } finally {
24        // 例外の有無にかかわらず、必ず実行されるコードを記述します
25        echo "finallyブロック: 処理を終了します。\n";
26    }
27
28    echo "\n--- ケース2: 例外が発生する場合 ---\n";
29    try {
30        echo "tryブロック: 処理を開始します。\n";
31        // 意図的に例外をスローするコード
32        $value = "abc";
33        if (!is_numeric($value)) {
34            // 例外を発生させます
35            throw new Exception("無効な数値が入力されました: '" . $value . "'");
36        }
37        $result = 10 / (int)$value;
38        echo "tryブロック: 処理が成功しました。結果: " . $result . "\n"; // この行は実行されません
39    } catch (Exception $e) {
40        // 例外が発生したため、このブロックが実行されます
41        echo "catchブロック: 例外を捕捉しました: " . $e->getMessage() . "\n";
42    } finally {
43        // 例外が発生しても、このブロックは必ず実行されます
44        echo "finallyブロック: 処理を終了します。\n";
45    }
46
47    echo "\n--- ケース3: 複数のcatchブロックと特定の例外を捕捉する場合 ---\n";
48    try {
49        echo "tryブロック: 処理を開始します。\n";
50        // 今回は0除算の例外を発生させます
51        $numerator = 10;
52        $denominator = 0;
53        if ($denominator === 0) {
54            throw new DivisionByZeroError("0で割ることはできません。");
55        }
56        $result = $numerator / $denominator;
57        echo "tryブロック: 処理が成功しました。\n";
58    } catch (DivisionByZeroError $e) {
59        // DivisionByZeroError型の例外を捕捉します
60        echo "catchブロック (DivisionByZeroError): 0除算エラーを捕捉しました: " . $e->getMessage() . "\n";
61    } catch (Exception $e) {
62        // その他の一般的なExceptionを捕捉します（このケースでは実行されません）
63        echo "catchブロック (汎用Exception): その他の例外を捕捉しました: " . $e->getMessage() . "\n";
64    } finally {
65        echo "finallyブロック: 処理を終了します。\n";
66    }
67}
68
69// 関数を実行します
70demonstrateTryCatchFinally();

PHPのtryキーワードは、プログラム実行中に発生する可能性のあるエラー（例外）を適切に処理し、アプリケーションの安定性を高めるための重要な構文です。このtryキーワード自体は引数や戻り値を持たず、例外発生の可能性があるコードを囲むために使用されます。

サンプルコードでは、try-catch-finallyブロックの基本的な使い方を示しています。tryブロックには、エラーが起こりうるコードを記述します。 ケース1では、例外が発生しない場合の正常な処理フローが示され、tryブロックのコードが成功裏に実行され、catchブロックはスキップされ、finallyブロックが実行されます。 ケース2のようにtryブロック内で例外が発生すると、その時点でtryブロック内の処理は停止し、直後のcatchブロックに処理が移ります。catchブロックでは、発生した例外を捕捉し、エラーメッセージ表示など適切な処理を行います。 ケース3では、複数のcatchブロックを定義することで、DivisionByZeroErrorのような特定の例外に対して、異なる処理を実行させることが可能です。 そしてfinallyブロックは、例外の発生有無にかかわらず、必ず実行されます。これは、リソースの解放など、確実に実行したい後処理に利用されます。 このtry-catch-finallyの仕組みを用いることで、予期せぬエラーによるプログラムのクラッシュを防ぎ、堅牢なシステムを構築できます。