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

Copy
1<?php
2
3/**
4 * PHPコードを解析し、T_CATCHトークンを検出する関数です。
5 *
6 * この関数は、指定されたPHPコード文字列を内部的にトークン（PHPがコードを理解するための最小単位）に分解し、
7 * T_CATCH（'catch'キーワードを表すトークン）を検出します。
8 * システムエンジニアを目指す初心者向けに、T_CATCHがPHPのパーサーがコードをどのように処理するかを
9 * 示す一例として提供されます。
10 */
11function demonstrateTCatchToken(): void
12{
13    // 解析対象となるPHPコード文字列です。
14    // T_CATCHは、この中の 'catch' キーワードに対応する内部的な識別子です。
15    $codeToAnalyze = <<<'PHP_CODE'
16<?php
17try {
18    // 何らかの処理を試みます
19    throw new Exception("意図的に例外を発生させました。");
20} catch (Exception $e) {
21    // 例外がスローされた場合に実行されるブロック
22    echo "エラーをキャッチしました: " . $e->getMessage() . "\n";
23} finally {
24    // 例外の有無にかかわらず、常に実行されるブロック
25    echo "処理が完了しました。\n";
26}
27PHP_CODE;
28
29    echo "--- PHPコード解析開始 ---\n";
30    echo "解析対象コード:\n";
31    echo $codeToAnalyze . "\n";
32    echo "--------------------------\n\n";
33
34    // `token_get_all()`関数は、PHPコード文字列をトークンの配列に分解します。
35    // 各トークンは通常、配列（トークンID、トークン文字列、行番号）または単一文字の文字列（'{', ';', など）として返されます。
36    $tokens = token_get_all($codeToAnalyze);
37
38    echo "--- T_CATCHトークンの検索 ---\n";
39    foreach ($tokens as $token) {
40        // トークンが配列形式の場合（キーワード、変数名、文字列リテラルなど）に処理します。
41        if (is_array($token)) {
42            // トークンIDが T_CATCH であるか確認します。
43            // T_CATCH は、PHP内部で 'catch' キーワードを表す定数です。
44            if ($token[0] === T_CATCH) {
45                echo "T_CATCHトークンを検出しました！\n";
46                echo "  - トークンID: " . $token[0] . " (" . token_name($token[0]) . ")\n";
47                echo "  - トークン文字列: '" . $token[1] . "'\n";
48                echo "  - 行番号: " . $token[2] . "\n\n";
49            }
50        }
51        // 単一文字のトークン（例: '{', '}', ';'）は、PHPの構文の一部であり、文字列として直接返されます。
52    }
53    echo "--- T_CATCHトークンの検索終了 ---\n\n";
54
55    echo "--- try...catchブロックの動作デモンストレーション ---\n";
56    // T_CATCHが関連する `try...catch` ブロックがどのように機能するかを実際に示します。
57    try {
58        echo "tryブロック: 例外をスローしようとしています。\n";
59        // ここで意図的に例外を発生させます。
60        throw new Exception("エラーメッセージ: ファイルが見つかりません。");
61    } catch (Exception $e) {
62        // 例外が発生した場合、この `catch` ブロックが実行されます。
63        // ここでエラーを安全に処理します。
64        echo "catchブロック: 例外をキャッチしました！エラー内容: " . $e->getMessage() . "\n";
65    } finally {
66        // `finally` ブロックは、例外が発生したかどうかにかかわらず、常に実行されます。
67        // リソースの解放など、クリーンアップ処理によく使われます。
68        echo "finallyブロック: 処理を終了します。\n";
69    }
70    echo "--- try...catchブロックの動作デモンストレーション終了 ---\n";
71}
72
73// 定義した関数を実行し、T_CATCHトークンの検出と
74// try...catchブロックの動作を確認します。
75demonstrateTCatchToken();

T_CATCHは、PHP言語の内部で定義されている特殊な定数であり、PHPがソースコードを解析する際に「catch」というキーワードを識別するために使用されるトークンIDを表します。PHPのパーサー（コードを読み解くプログラム）は、コード内のすべての要素を「トークン」という最小単位に分解しますが、T_CATCHはそのうち「catch」キーワードに割り当てられた固有の番号です。この定数自体は引数を取らず、特定の値を戻り値として返すことはありません。

このサンプルコードでは、まず指定されたPHPコード文字列をtoken_get_all()関数を使ってトークンの配列に分解し、その中からT_CATCHトークン（catchキーワードに対応）を検出する過程を示しています。これにより、PHPが内部的にコードをどのように理解しているかの一端を垣間見ることができます。

さらに、T_CATCHが関連するtry...catch...finallyブロックの実際の動作もデモンストレーションしています。tryブロックで意図的に例外を発生させ、その例外がcatchブロックによって安全に処理される様子、そしてfinallyブロックが例外の有無にかかわらず必ず実行されることを見せます。このコードを通して、T_CATCHという内部定数が、PHPの重要な例外処理メカニズムと深く結びついていることが具体的に理解できます。

Copy
1<?php
2
3/**
4 * 除算を行い、ゼロ除算の場合は例外をスローする関数。
5 *
6 * @param float $numerator 除数
7 * @param float $denominator 被除数
8 * @return float 除算結果
9 * @throws InvalidArgumentException 被除数が0の場合
10 */
11function divide(float $numerator, float $denominator): float
12{
13    if ($denominator === 0.0) {
14        // throw キーワードを使用してエラー状況を通知する例外をスローします。
15        throw new InvalidArgumentException('Denominator cannot be zero.');
16    }
17    return $numerator / $denominator;
18}
19
20/**
21 * PHPにおける例外処理 (try-catch-finally) の使用方法をデモンストレーションします。
22 * T_CATCH は 'catch' キーワードの内部的なトークン識別子であり、
23 * このデモンストレーションは、そのトークンが表す 'catch' 機能の具体的な使用例を示します。
24 */
25function demonstrateExceptionHandling(): void
26{
27    echo "--- PHP例外処理のデモンストレーション ---" . PHP_EOL;
28
29    // 正常に実行されるケース
30    try {
31        echo "5 / 2 = " . divide(5, 2) . PHP_EOL;
32    } catch (Throwable $e) {
33        // 例外が発生しなかったため、この catch ブロックは実行されません。
34        echo "エラーが発生しました (予期せぬ): " . $e->getMessage() . PHP_EOL;
35    } finally {
36        // finally ブロックは例外の有無にかかわらず常に実行されます。
37        echo "クリーンアップ処理 (正常ケース)." . PHP_EOL . PHP_EOL;
38    }
39
40    // 例外が発生するケース
41    try {
42        echo "10 / 0 = " . divide(10, 0) . PHP_EOL;
43    } catch (InvalidArgumentException $e) {
44        // catch キーワードを使用して、特定の例外型 (InvalidArgumentException) を捕捉します。
45        echo "エラーが発生しました (ゼロ除算): " . $e->getMessage() . PHP_EOL;
46    } catch (Throwable $e) {
47        // それ以外の全ての例外を捕捉するためのフォールバックとして使用できます。
48        echo "予期せぬエラーが発生しました: " . $e->getMessage() . PHP_EOL;
49    } finally {
50        echo "クリーンアップ処理 (エラーケース)." . PHP_EOL . PHP_EOL;
51    }
52
53    echo "--- デモンストレーション終了 ---" . PHP_EOL;
54}
55
56// 例外処理のデモンストレーション関数を実行
57demonstrateExceptionHandling();
58
59?>

T_CATCHは、PHPが内部的にcatchキーワードを識別するために用いる定数です。このサンプルコードは、そのcatchキーワードが示す「例外処理」の具体的な使用方法を初心者の方にも分かりやすく説明します。

divide関数は、引数で受け取った二つの数値の除算を行い、その結果を浮動小数点数で返します。ただし、第二引数である被除数$denominatorが0.0の場合、ゼロ除算エラーを防ぐため、throwキーワードを使ってInvalidArgumentExceptionというエラー状況を通知する例外をスローします。これにより、関数が予期せぬ状態になったことを呼び出し元に確実に伝えます。

demonstrateExceptionHandling関数は引数を取らず、戻り値もありませんが、try-catch-finallyブロックを使った例外処理の動作を実演します。 tryブロック内には、例外が発生する可能性のあるコードを記述します。 catchブロックは、tryブロック内でスローされた例外を捕捉し、適切に処理するために使用されます。特定の例外型（例: InvalidArgumentException）を指定することで、その例外のみを処理できます。複数のcatchブロックを記述して、具体的な例外からより一般的な例外へと処理を段階的に試みることが可能です。 finallyブロックは、例外が発生したかどうかに関わらず、必ず実行される処理を記述する場所です。これにより、リソースの解放など、プログラムの最終的なクリーンアップ処理を確実に行うことができます。 このコードは、PHPにおける安全で安定したプログラム開発のための例外処理の基本を示しています。