【PHP8.x】Random\RandomException::getLine()メソッドの使い方

Copy
1<?php
2
3// PHP 8 以降で導入された Random 拡張機能の例外クラスをインポートします。
4use Random\RandomException;
5
6/**
7 * Random\RandomException::getLine() メソッドの使用例を示します。
8 * このメソッドは、例外が発生したコードの行番号を返します。
9 *
10 * この例では、getLine() メソッドの動作を示すために、
11 * 意図的に Random\RandomException をスローしています。
12 */
13function demonstrateRandomExceptionGetLine(): void
14{
15    echo "--- Random\\RandomException::getLine() のデモンストレーション ---\n\n";
16
17    try {
18        // ここで意図的に Random\RandomException をスローします。
19        // 実際のアプリケーションでは、Random\Engine や Random\Randomizer の
20        // 内部エラーなどが原因で発生する可能性があります。
21        throw new RandomException("これはデモンストレーション用のRandom例外です。");
22
23        // 例外がスローされたため、この行以降は実行されません。
24        echo "このメッセージは表示されません。\n";
25
26    } catch (RandomException $e) {
27        // Random\RandomException が捕捉された場合、その情報を表示します。
28        echo "Random\RandomException が発生しました！\n";
29        echo "例外メッセージ: " . $e->getMessage() . "\n";
30        echo "発生ファイル: " . $e->getFile() . "\n";
31        // getLine() メソッドを呼び出し、例外が発生した行番号を取得します。
32        echo "発生行番号: " . $e->getLine() . "\n"; // この行で getLine() が呼び出されています
33    } catch (Throwable $e) {
34        // その他の予期せぬ例外（PHP 7以降のすべてのエラーや例外を捕捉）が発生した場合
35        echo "予期せぬエラーが発生しました。\n";
36        echo "エラータイプ: " . get_class($e) . "\n";
37        echo "エラーメッセージ: " . $e->getMessage() . "\n";
38    }
39
40    echo "\n--- デモンストレーション終了 ---\n";
41}
42
43// 関数を実行してデモンストレーションを開始します。
44demonstrateRandomExceptionGetLine();
45
46?>

PHP 8以降で導入されたRandom拡張機能の例外クラスであるRandom\RandomExceptionには、getLine()メソッドが提供されています。このメソッドは、例外が発生したソースコードの正確な行番号を整数（int型）で返す役割を持ち、引数を必要としません。

サンプルコードでは、demonstrateRandomExceptionGetLine関数内でtry-catch文を使い、Random\RandomExceptionを意図的にスローしています。これは、Random\EngineやRandom\Randomizerなどの内部でエラーが発生した際の状態を模擬しています。例外が捕捉されると、catchブロック内で$e->getLine()メソッドが呼び出され、例外が実際に発生したソースコードの行番号を取得・表示しています。この行番号の情報は、プログラムの動作がおかしくなった場合に、問題が発生した箇所を迅速に特定し、デバッグ作業を効率的に進める上で非常に有用です。