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

getLineメソッドは、例外がスローされたソースコードのファイルにおける行番号を取得する処理を実行するメソッドです。このメソッドは、プログラムの実行中にエラーが発生した際、その原因となったコードが具体的に何行目に書かれているかを特定するために使用されます。特に、デバッグ作業においてエラー箇所の迅速な発見に大変役立ちます。getLineメソッドは、通常try-catch構文のcatchブロック内で使用され、捕捉したRangeExceptionなどの例外オブジェクトから呼び出します。戻り値は、例外が発生した行番号を示す整数値です。このメソッドは、PHPの基本的な例外クラスであるExceptionクラスで定義されているため、RangeExceptionだけでなく、Exceptionを継承する他の多くの例外クラスでも同様に利用することが可能です。これにより、さまざまな種類の例外処理において、一貫した方法で行番号を特定できます。エラーログを記録する際、getFileメソッドで得られるファイル名とこのメソッドで得られる行番号を組み合わせることで、エラーの原因究明をより効率的に進めることができます。

Copy
1<?php
2
3try {
4    // この行 (5行目) で例外をスローします
5    throw new RangeException("値が範囲外です");
6} catch (RangeException $e) {
7    // 例外がスローされた行番号を取得します
8    $lineNumber = $e->getLine();
9    echo $lineNumber; // "5" を出力します
10}

引数なし

引数はありません

int

このメソッドは、例外が発生したソースコードの行番号を整数で返します。