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

lineプロパティは、ArithmeticErrorクラスのインスタンスにおいて、エラーが発生したソースコードの行番号を保持するプロパティです。

ArithmeticErrorクラスは、PHPで算術演算に関するエラーが発生した場合にスローされるエラーの一つです。例えば、intdiv()関数でゼロによる除算を試みた際などに発生します。このエラーオブジェクトが生成されると、lineプロパティには、エラーが実際に発生したPHPスクリプト内の具体的な行番号が自動的に格納されます。

このプロパティは、PHPのエラーや例外の基底となるThrowableインターフェース（およびその子孫であるErrorクラス）によって提供される共通のプロパティであり、あらゆる種類のエラーや例外オブジェクトで利用できます。エラー発生時のデバッグ作業において、エラーがどのファイル、どの行で発生したかを特定することは非常に重要であり、このlineプロパティはそのための不可欠な情報を提供します。

開発者は、try-catchブロックを使用してArithmeticErrorを捕捉し、そのオブジェクトからlineプロパティの値を取得することで、エラーの原因を迅速に特定し、適切なエラー処理やログ記録を行うことができます。このプロパティは読み取り専用であり、エラーオブジェクトが一度生成された後はその値を変更することはできません。

Copy
1<?php
2
3try {
4    // この行で DivisionByZeroError (ArithmeticError の子クラス) がスローされる
5    $result = 10 / 0;
6} catch (ArithmeticError $e) {
7    echo $e->line;
8}

int

ArithmeticError クラスの line プロパティは、エラーが発生したソースコードの行番号を整数で返します。