【PHP8.x】BadFunctionCallException::getLine()メソッドの使い方

getLineメソッドの使い方について、初心者にもわかりやすく解説します。

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

基本的な使い方

getLineメソッドは、BadFunctionCallException例外がスローされたソースコード上の行番号を取得するために実行するメソッドです。このメソッドは、PHPの例外処理の基本となるExceptionクラスで定義されており、BadFunctionCallExceptionクラスはこれを継承しているため利用できます。したがって、他の多くの例外クラスでも同様に使用することが可能です。BadFunctionCallExceptionは、存在しない関数を呼び出そうとした場合や、関数に渡す引数が不足している場合など、関数呼び出しに関するエラーが発生した際にスローされます。プログラムの実行中にこの例外が発生した際、try-catch構文で捕捉した例外オブジェクトに対してgetLineメソッドを呼び出すことで、問題が発生した具体的な行を特定できます。この機能は、デバッグ作業においてエラーの原因を迅速に突き止めるために不可欠です。取得した行番号は、getFileメソッドで得られるファイル名と組み合わせることで、エラー箇所の特定をより正確に行えます。メソッドの返り値は、行番号を表す整数値となります。

構文(syntax)


1<?php
2
3try {
4    // 存在しない関数をコールバックとして呼び出そうとする
5    call_user_func('non_existent_function');
6} catch (BadFunctionCallException $e) {
7    // 例外がスローされた行番号を取得する
8    $line = $e->getLine();
9    echo "例外がスローされた行番号: " . $line;
10}

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

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

サンプルコード

PHP BadFunctionCallException getLine() で行番号を取得する


1<?php
2
3/**
4 * BadFunctionCallExceptionを意図的に発生させ、getLine()メソッドの使用例を示します。
5 *
6 * BadFunctionCallExceptionは、存在しない関数を呼び出そうとした場合などにスローされます。
7 */
8function demonstrateGetLine(): void
9{
10    try {
11        // 存在しない関数を呼び出すことで、BadFunctionCallExceptionを発生させます。
12        // この行で例外がスローされます。
13        call_user_func('non_existent_function');
14    } catch (BadFunctionCallException $e) {
15        // スローされた例外をキャッチします。
16        echo "エラーが発生しました。\n";
17
18        // getLine()メソッドを使用して、例外がスローされた行番号を取得し、表示します。
19        // この場合、上記のcall_user_func()が記述されている行番号が出力されます。
20        echo "例外発生行: " . $e->getLine() . "\n";
21
22        // 参考: getMessage()でエラーメッセージも取得できます。
23        echo "メッセージ: " . $e->getMessage() . "\n";
24    }
25}
26
27// 関数を実行します。
28demonstrateGetLine();

PHPのBadFunctionCallExceptionクラスに属するgetLine()メソッドについて説明します。このメソッドは、プログラム実行中にBadFunctionCallExceptionという例外が発生した際に、その原因となったソースコードの行番号を取得するために使用されます。getLine()メソッドは引数を取らず、戻り値として例外が発生した行番号を整数(int)で返します。

BadFunctionCallExceptionは、存在しない関数を呼び出そうとした場合や、関数の引数が不正な場合などにスローされる例外です。サンプルコードでは、tryブロック内でcall_user_func()を用いて意図的に存在しない関数を呼び出し、この例外を発生させています。

catchブロックでは、発生した例外を捕捉し、そのオブジェクトが持つgetLine()メソッドを呼び出しています。これにより、例外がスローされたcall_user_func()の行番号が取得され、画面に出力されます。プログラム開発において、エラーが発生した正確な場所を特定することはデバッグの第一歩です。このメソッドは、エラーの原因箇所を迅速に突き止めるための重要な手がかりとなります。

getLine()メソッドは、デバッグ時にエラーの発生箇所を特定するのに役立ちます。注意点として、このメソッドが返す行番号は、あくまで例外がスローされた行であり、エラーの根本的な原因がある行とは限らないことを理解しておく必要があります。より正確な原因調査のためには、getMessage()でエラー内容を、getFile()でファイル名を確認するなど、他のデバッグ情報と組み合わせて利用することが重要です。また、getLine()で得た行番号などの詳細なエラー情報を、そのままウェブサイトの画面に表示しないでください。攻撃者にサーバー内部の情報与えることになり、セキュリティ上のリスクとなります。エラーの詳細はログファイルに記録し、利用者には汎用的なメッセージを表示するようにしましょう。