【PHP8.x】getLineメソッドの使い方

getLineメソッドは、PHP 8において、内部的なTypeErrorクラスに属し、エラーが発生したソースコードの行番号を取得するメソッドです。TypeErrorは、プログラム内で期待されるデータ型と異なる値が渡された際に発生するエラーを表します。例えば、関数が数値型を引数として期待しているにもかかわらず、誤って文字列型が渡された場合などにこのTypeErrorが発生します。

このgetLineメソッドは、そうした型に関する間違いが起きたTypeErrorオブジェクトから、そのエラーがPHPスクリプトの具体的に何行目で発生したのかという情報を取り出すために利用されます。エラーの発生源となる正確な行番号を知ることは、開発者がプログラムの不具合（バグ）を特定し、修正するデバッグ作業において極めて重要な情報となります。

通常、このメソッドは例外処理のtry-catchブロック内でTypeErrorを捕捉した際に呼び出されます。捕捉したTypeErrorオブジェクトに対してgetLine()を呼び出すことで、エラーメッセージの一部として行番号を表示したり、ログファイルに出力したりすることができます。これにより、システムエンジニアはエラーの発生箇所を迅速に特定し、コードの品質向上と安定稼働に貢献することができます。

Copy
1<?php
2
3function divide(int $a, int $b): float
4{
5    return $a / $b;
6}
7
8try {
9    divide(10, "two"); // ここでTypeErrorが発生する
10} catch (TypeError $e) {
11    echo "エラーが発生した行: " . $e->getLine() . PHP_EOL;
12}

引数なし

引数はありません

int

このメソッドは、例外が発生したソースコードの行番号を整数で返します。