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

lineプロパティは、エラーが発生したソースコードの行番号を保持するプロパティです。このプロパティは、PHPの組み込み例外クラスであるValueErrorクラスに属しています。ValueErrorは、主に引数の型は正しいものの、その値が期待される範囲や形式に合致しない場合にスローされる例外です。

プログラムの実行中にValueErrorが発生し、try...catchブロックなどでその例外を捕捉した場合、lineプロパティを参照することで、エラーが実際にどのソースコードの行で発生したのかを数値で取得できます。例えば、特定の関数に無効な数値や形式のデータが渡された際にValueErrorが発生した場合、このプロパティはエラーの原因となった行番号を示します。

この行番号の情報は、デバッグ作業において非常に重要です。開発者はlineプロパティの値を利用して、問題のあるコード箇所を素早く特定し、修正することができます。ValueErrorクラスのlineプロパティは、より詳細なエラー情報を取得し、プログラムの信頼性を高めるために不可欠な要素です。

Copy
1<?php
2try {
3    // ValueErrorが発生する可能性のあるコード
4    // 例として明示的にValueErrorをスロー
5    throw new ValueError('不正な値が検出されました。');
6} catch (ValueError $e) {
7    // ValueErrorオブジェクトのlineプロパティにアクセス
8    $lineNumber = $e->line;
9}

int

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