【PHP8.x】lineプロパティの使い方

lineプロパティは、例外がスローされたソースコード内の行番号を保持するプロパティです。このプロパティは、PHPの全ての例外の基底クラスであるExceptionクラスで定義されており、UnexpectedValueExceptionクラスはこれを継承しています。UnexpectedValueExceptionは、値が期待される型や範囲に一致しない場合など、予期しない値が与えられた際に発生するエラー状況を表すために使用されます。プログラムの実行中にこの種の例外が発生した際、どのファイルの何行目で問題が起きたのかを特定することは、デバッグ作業において非常に重要です。lineプロパティが保持する行番号は、この原因究明において不可欠な情報となります。このプロパティはprotectedとして宣言されているため、クラスの外部から直接アクセスすることはできません。値を取得するには、公開されているgetLine()メソッドを使用する必要があります。try...catchブロックで例外オブジェクトを捕捉し、そのオブジェクトのgetLine()メソッドを呼び出すことで、エラーが発生した正確な行番号を整数値として取得し、ログ記録などのデバッグ処理に役立てることができます。

Copy
1<?php
2
3try {
4    throw new UnexpectedValueException("予期しない値が検出されました。");
5} catch (UnexpectedValueException $e) {
6    // lineプロパティの値を取得します
7    echo $e->getLine();
8}

引数なし

引数はありません

int

UnexpectedValueException クラスの line プロパティは、例外が発生したソースコードの行番号を整数で返します。