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

Copy
1<?php
2
3try {
4    // 無効な日付文字列をDatePeriodに渡して例外を発生させる
5    new DatePeriod('Invalid date string', new DateInterval('P1D'), new DateTime());
6} catch (DateMalformedStringException $e) {
7    // 例外が発生した場合、スタックトレースを取得して出力する
8    $trace = $e->getTrace();
9
10    echo "スタックトレース:\n";
11    print_r($trace);
12
13    // スタックトレースを文字列として取得することも可能です。（キーワード：php gettraceasstring）
14    // この場合は、debug_print_backtrace() 関数を使用します。
15    // ただし、DateMalformedStringException クラス自体には getTraceAsString() のようなメソッドは存在しません。
16    // debug_print_backtrace() は、より広範なデバッグ情報を提供します。
17    echo "\nスタックトレース (文字列):\n";
18    debug_print_backtrace();
19}
20
21?>

このサンプルコードは、PHP 8における DateMalformedStringException クラスの getTrace メソッドの使い方を示しています。DateMalformedStringException は、日付文字列の形式が不正な場合に発生する例外です。

コードでは、まず try-catch ブロックを用いて、意図的に無効な日付文字列を DatePeriod コンストラクタに渡し、例外を発生させています。catch ブロック内で、DateMalformedStringException オブジェクト $e の getTrace メソッドを呼び出しています。

getTrace メソッドは引数を取りません。このメソッドは、例外が発生した時点でのスタックトレースを配列として返します。スタックトレースには、例外発生に至るまでの関数呼び出しの履歴が記録されています。サンプルコードでは、print_r 関数を使って、取得したスタックトレースの内容を画面に出力しています。これにより、例外発生の原因を特定するための情報が得られます。

サンプルコードには、スタックトレースを文字列として取得する方法も記載されています。ただし、DateMalformedStringException クラス自体には getTraceAsString() のようなメソッドは存在しません。代わりに、debug_print_backtrace() 関数を使用することで、スタックトレースを文字列として出力できます。debug_print_backtrace() は、より詳細なデバッグ情報を提供する際に役立ちます。