【PHP8.x】getPreviousメソッドの使い方

Copy
1<?php
2
3/**
4 * DOMException の getPrevious メソッドのサンプルコード
5 */
6try {
7    // 例：DOMDocument のロードに失敗するケースを想定
8    $dom = new DOMDocument();
9    $dom->loadHTMLFile('invalid_file.html'); // 存在しないファイル
10} catch (DOMException $e) {
11    // 前の例外を取得
12    $previousException = $e->getPrevious();
13
14    if ($previousException) {
15        echo "前の例外メッセージ: " . $previousException->getMessage() . PHP_EOL;
16    } else {
17        echo "前の例外は存在しません。" . PHP_EOL;
18    }
19
20    echo "現在の例外メッセージ: " . $e->getMessage() . PHP_EOL;
21}
22
23?>

PHP 8 の DOMException クラスにおける getPrevious メソッドは、例外が発生する前に発生した例外（前の例外）を取得するために使用します。これは、例外が連鎖的に発生した場合に、根本原因を特定するのに役立ちます。

サンプルコードでは、まず DOMDocument のロードに失敗する可能性のある処理を try ブロックで囲みます。invalid_file.html という存在しないファイルをロードしようとすることで、DOMException が発生するようにしています。

catch ブロックでは、発生した DOMException オブジェクトを受け取り、getPrevious() メソッドを呼び出して前の例外を取得します。getPrevious() メソッドは引数を取りません。戻り値は ?Throwable 型であり、前の例外が存在する場合はその例外オブジェクトを、存在しない場合は null を返します。

サンプルコードでは、取得した前の例外が存在するかどうかを確認し、存在する場合はその例外メッセージを表示します。前の例外が存在しない場合は、その旨を表示します。最後に、現在の例外メッセージを表示します。これにより、例外の連鎖構造を理解し、デバッグに役立てることができます。getPrevious() メソッドを利用することで、例外の原因をより深く掘り下げることが可能になります。