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

lineプロパティは、例外がスローされたソースコードの行番号を保持するプロパティです。このプロパティは、InvalidArgumentExceptionクラスが継承している基底のExceptionクラスで定義されています。InvalidArgumentExceptionは、関数の引数に予期しない型の値が渡された場合など、引数が無効であるときに発生する例外です。プログラムの実行中にこの例外がスローされると、PHPエンジンはエラーの原因となったコードが記述されているファイルの行番号を、このlineプロパティに自動的に格納します。この情報はデバッグ作業において非常に重要であり、問題が発生した箇所を迅速に特定するのに役立ちます。通常、このプロパティの値はprotectedであるため直接アクセスせず、try-catchブロックで捕捉した例外オブジェクトのgetLine()メソッドを呼び出すことで取得します。取得した行番号をログに出力するなどして、効率的なエラー解決に繋げることができます。

Copy
1<?php
2
3try {
4    // この行で例外がスローされます
5    throw new InvalidArgumentException("An error occurred.");
6} catch (InvalidArgumentException $e) {
7    // getLine() メソッドで例外が発生した行番号を取得します
8    $line = $e->getLine();
9    echo "Exception thrown on line: " . $line;
10}

引数なし

引数はありません

int

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