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

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

作成日: 2025年09月11日更新日: 2025年10月12日

基本的な使い方

lineプロパティは、ErrorExceptionクラスに属し、エラーが発生したソースコードの行番号を保持するプロパティです。PHPでは通常、文法エラーや実行時エラーなど様々な問題が発生しますが、ErrorExceptionクラスは、これらのPHPのエラーを捕捉し、一般的な例外（Exception）と同じようにオブジェクトとして扱うことを可能にします。

このlineプロパティは、ErrorExceptionオブジェクトが生成された際に、具体的にどのファイルのどの行でエラーが発生したのかという情報を数値として格納しています。例えば、誤った変数を参照したり、存在しない関数を呼び出したりした際に、PHPはエラーを発生させますが、そのエラーをErrorExceptionとして扱う場合、このlineプロパティを参照することで、問題の正確な発生箇所を行番号で特定できるのです。

システム開発においてデバッグ作業は非常に重要ですが、このlineプロパティは、エラーの根本原因を素早く突き止めるための重要な手がかりとなります。エラーログを解析する際や、開発中に予期せぬ挙動に直面した際に、lineプロパティから得られる情報によって、コードのどの部分を修正すべきか、あるいはどのような状況でエラーが発生したのかを効率的に把握できます。PHP 8においても、エラーハンドリングの基本的な仕組みとして、このプロパティは重要な役割を担っています。

構文(syntax)


1<?php
2// ErrorException オブジェクトの line プロパティは、エラーが発生した行番号を整数で提供します。
3$error = new ErrorException('エラーが発生しました', 0, E_ERROR, 'ファイル名.php', 123);
4echo $error->line;

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

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

サンプルコード

PHP ErrorExceptionで発生行を取得する


1<?php
2
3// ErrorException を発生させて、発生行を取得する例
4try {
5    throw new ErrorException("エラー発生", 0, 1, __FILE__, __LINE__);
6} catch (ErrorException $e) {
7    $line = $e->getLine(); // エラーが発生した行番号を取得
8
9    echo "エラーが発生した行: " . $line . PHP_EOL;
10}
11
12?>

PHPのErrorExceptionクラスにおけるlineプロパティは、例外が発生した行番号を保持する内部プロパティです。直接アクセスすることは推奨されていませんが、getLine()メソッドを利用することで、その値を取得できます。

上記のサンプルコードでは、ErrorExceptionを発生させて、その例外オブジェクトからgetLine()メソッドを使って行番号を取得する例を示しています。まず、try-catchブロックの中でErrorExceptionを throw しています。この際、__FILE__と__LINE__という定義済み定数を使用しています。__FILE__はファイル名、__LINE__は現在の行番号を表します。

次に、catchブロックでErrorExceptionオブジェクト $e を受け取り、$e->getLine()を呼び出すことで、例外が発生した行番号を取得し、$line変数に格納します。最後に、echo文を使って、取得した行番号をターミナルに出力しています。

getLine()メソッドは引数を持ちません。戻り値は整数型（int）で、例外が発生した行番号です。この情報を使って、エラーが発生した場所を特定し、デバッグ作業に役立てることができます。ErrorExceptionに限らず、Exceptionクラスを継承した他の例外クラスでも同様にgetLine()メソッドを利用できます。

ErrorExceptionクラスのlineプロパティは、例外が発生した行番号を保持しています。サンプルコードでは、getLine()メソッドを用いてその値を取得しています。__LINE__は、コードが記述された行番号を表すPHPの定義済み定数です。ErrorExceptionを発生させる際に、__LINE__を引数に渡すことで、例外発生箇所を特定できます。try-catchブロック内で例外を適切に処理しない場合、プログラムが予期せぬ動作をする可能性があります。ErrorExceptionを扱う際は、必ず例外処理を実装するようにしましょう。また、lineプロパティは読み取り専用であり、直接値を変更することはできません。

PHP ErrorException::lineでエラー発生行番号を取得する


1<?php
2
3/**
4 * 例外発生時の行番号を取得するサンプル
5 */
6try {
7    // 意図的にエラーを発生させる
8    trigger_error("これはテストエラーです", E_USER_ERROR);
9} catch (ErrorException $e) {
10    // ErrorExceptionオブジェクトからエラーが発生した行番号を取得
11    $lineNumber = $e->getLine();
12
13    // 行番号を出力
14    echo "エラーが発生した行番号: " . $lineNumber . PHP_EOL;
15}
16
17?>

このPHPサンプルコードは、ErrorExceptionクラスのlineプロパティを使用して、例外が発生した行番号を取得する方法を示しています。

まず、try-catchブロック内で、trigger_error()関数を使用して意図的にエラーを発生させています。この関数は、カスタムエラーを発生させることができ、ここではE_USER_ERRORというエラーレベルを指定しています。

次に、catchブロックでErrorExceptionオブジェクト $e を受け取ります。ErrorExceptionは、PHPのエラーを例外として扱う場合に利用されるクラスです。

ErrorExceptionオブジェクト $e から、getLine() メソッドを使用し、エラーが発生した行番号を取得します。getLine()メソッドは、引数を取りません。戻り値として、エラーが発生した行番号を整数値 (int) で返します。

最後に、取得した行番号を echo 文で出力しています。PHP_EOL は改行コードを表し、出力結果を見やすくするために追加しています。

このコードを実行すると、「エラーが発生した行番号:」に続いて、trigger_error()関数が呼び出された行番号が表示されます。これにより、例外が発生した場所を特定し、デバッグに役立てることができます。ErrorExceptionのlineプロパティは、例外発生箇所の特定に不可欠な情報を提供します。

ErrorExceptionクラスのlineプロパティは、例外が発生した行番号を取得するために使用します。直接アクセスは推奨されず、getLine()メソッドを使用してください。trigger_error()などで意図的にエラーを発生させた場合、ErrorExceptionオブジェクトが生成され、その際にlineプロパティに値が設定されます。try-catchブロックでErrorExceptionをキャッチし、getLine()メソッドでエラー発生箇所を特定できます。E_USER_ERRORのようなエラーレベルを指定した場合、スクリプトの実行が中断される可能性があるため、注意が必要です。本番環境ではエラーメッセージをそのまま出力せず、ログファイルに記録するなど、セキュリティ対策を講じることが重要です。