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

lineプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

『lineプロパティは、例外がスローされたソースコードの行番号を保持するプロパティです。このプロパティは、PHPの基本的な例外クラスであるExceptionクラスで定義されています。DomainExceptionExceptionクラスを継承しているため、DomainExceptionのオブジェクトもこのlineプロパティを持っています。プログラムの実行中に、ある値が期待される範囲外であるといった理由でDomainExceptionが発生した場合、このプロパティには、その例外がどのファイルの何行目で発生したかという具体的な位置情報が自動的に格納されます。この行番号は、開発者がデバッグを行う際に、エラーの原因となっている箇所を迅速に特定するための非常に重要な手がかりとなります。通常、このプロパティに格納された値は、オブジェクトに用意されているgetLine()メソッドを呼び出すことで取得します。try-catch構文で例外を捕捉し、このメソッドを使うことで、エラーの発生行をログに出力するなど、詳細なエラーハンドリングを実装できます。このようにlineプロパティは、エラーの発生源を正確に突き止め、プログラムの安定性を向上させるために不可欠な情報を提供します。』

構文(syntax)

1<?php
2
3try {
4    throw new DomainException('ドメインエラーが発生しました。');
5} catch (DomainException $e) {
6    echo $e->getLine();
7}

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

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