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

lineプロパティは、例外がスローされたソースコードの行番号を保持するプロパティです。このプロパティは、OverflowExceptionクラスが親クラスであるExceptionから継承しているため、OverflowExceptionのインスタンスからも利用することができます。OverflowExceptionは、算術演算の結果がデータ型で表現できる範囲を超えてしまうといった、いわゆるオーバーフローが発生した際にスローされる例外です。プログラムの実行中にこのような例外が発生すると、PHPエンジンはエラーが起きたファイル名（fileプロパティ）と共に、そのファイル内の具体的な行番号をこのlineプロパティに自動的に設定します。この情報は、デバッグ作業において非常に重要です。エラーログやcatchブロック内で例外オブジェクトのlineプロパティを参照することにより、開発者は問題が発生したコード上の正確な位置を迅速に特定し、修正作業を効率的に進めることが可能になります。通常、このプロパティの値はgetLine()メソッドを介して取得します。このプロパティは読み取り専用として扱われ、エラー発生時にシステムによって値が設定されるため、開発者が直接値を代入することはありません。

Copy
1<?php
2
3try {
4    $array = new SplFixedArray(1);
5    $array[1] = 'value';
6} catch (OverflowException $e) {
7    // getLine() メソッドで例外が発生した行番号を取得します
8    echo $e->getLine();
9}
10
11?>

引数なし

引数はありません

int

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