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

『lineプロパティは、RangeException例外がスローされたソースコード上の行番号を保持するプロパティです。このプロパティは、PHPの基本的な例外クラスであるExceptionから継承されているため、RangeExceptionを含む多くの例外オブジェクトで利用できます。プログラムの実行中に、値が期待される有効な範囲にないといった問題が発生した場合、どのファイルのどの行でその問題が起きたのかを正確に特定することは、デバッグ作業において非常に重要です。lineプロパティにはその発生箇所の行番号が数値として格納されており、開発者はエラーの原因を迅速に突き止めるための手がかりを得ることができます。通常、このプロパティはprotectedとして定義されているため、オブジェクトから直接アクセスするのではなく、公開されているgetLine()メソッドを使用して値を取得します。try-catch構文でRangeExceptionを捕捉した際に、その例外オブジェクトのgetLine()メソッドを呼び出すことで、具体的なエラー発生箇所を把握し、プログラムの修正に役立てることが可能です。

Copy
1<?php
2
3function checkAge(int $age)
4{
5    if ($age < 0 || $age > 150) {
6        throw new RangeException("Age is out of the valid range.");
7    }
8}
9
10try {
11    checkAge(200);
12} catch (RangeException $e) {
13    // Access the protected 'line' property value via the public getLine() method.
14    echo $e->getLine();
15}
16

引数なし

引数はありません

int

このプロパティは、例外が発生した行番号を整数型で返します。