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

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

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

基本的な使い方

getLineメソッドは、PHPのFiberErrorクラスに属し、ファイバーの実行中に発生したエラーの発生源となったソースコードの行番号を取得するために使用されるメソッドです。

PHP 8.1以降で導入されたファイバーは、ノンブロッキングI/Oなどの非同期処理をより効率的に記述するための機能です。複雑なファイバー処理を行う中で、予期せぬエラーや例外が発生することは避けられません。そのような状況で、FiberErrorオブジェクトが捕捉された際に、このgetLineメソッドを呼び出すことで、問題が具体的にどのコードの行で発生したのかを正確に特定することができます。

この情報は、エラーの原因を究明し、プログラムのデバッグを行う上で非常に重要です。例えば、try-catchブロックでFiberErrorを捕捉し、その内部で$fiberError->getLine()のように呼び出すことで、エラーメッセージやログに出力する際に、具体的な行番号を含めることが可能になります。これにより、開発者は迅速に問題のある箇所にたどり着き、修正作業を進めることができるため、効率的なエラーハンドリングとデバッグフローの確立に貢献します。

FiberErrorクラスは、PHPの基本的なエラー・例外処理の仕組みであるThrowableインターフェースを実装しているため、他の例外クラスが持つgetLineメソッドと同様の役割を果たします。ファイバーを利用したアプリケーション開発において、エラー発生時の詳細な情報収集に不可欠なメソッドと言えるでしょう。

構文(syntax)


1<?php
2try {
3    throw new FiberError("エラーが発生しました。");
4} catch (FiberError $e) {
5    $errorLine = $e->getLine();
6}

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

FiberError クラスの getLine メソッドは、エラーが発生したソースコードの行番号を整数で返します。

サンプルコード

FiberError::getLine() でエラー行番号を取得する


1<?php
2
3/**
4 * FiberError::getLine() の使用例
5 *
6 * FiberErrorは、Fiberの操作が不正な場合（例: 開始されていないFiberを再開しようとする）
7 * にスローされる例外です。
8 * getLine()メソッドは、その例外が発生したソースコードの行番号を返します。
9 */
10function demonstrateFiberErrorGetLine(): void
11{
12    // Fiberを作成しますが、まだ開始しません。
13    // FiberはPHP 8.1で導入された機能です。
14    $fiber = new Fiber(function (): void {
15        // このコードは実行されません
16    });
17
18    try {
19        // 開始(start)されていないFiberを再開(resume)しようとすると、
20        // この行で FiberError がスローされます。
21        $fiber->resume();
22    } catch (FiberError $e) {
23        // スローされたFiberError例外をキャッチします。
24        echo "例外がキャッチされました。" . PHP_EOL;
25        echo "エラーメッセージ: " . $e->getMessage() . PHP_EOL;
26
27        // getLine()メソッドで、例外が発生した行番号を取得して表示します。
28        // 上記の $fiber->resume(); の行番号が出力されます。
29        echo "エラー発生行番号: " . $e->getLine() . PHP_EOL;
30    }
31}
32
33demonstrateFiberErrorGetLine();
34

PHPのFiberError::getLine()メソッドは、プログラムの実行中にFiberに関するエラー（FiberError）が発生した際に、そのエラーがソースコードのどの行で起きたのかを特定するために使われます。FiberはPHP 8.1で導入された非同期処理を行うための機能です。

FiberErrorは、Fiberが不正な操作（例えば、まだ開始されていないFiberを再開しようとするなど）を受けた場合にスローされる例外です。このgetLine()メソッドは引数を必要とせず、例外が発生した正確なソースコードの行番号を整数（int）として返します。

提供されたサンプルコードでは、まずFiberオブジェクトを作成しますが、すぐに開始はしません。その後にtry-catchブロックを使い、開始されていないFiberをresume()メソッドで再開しようとします。この不正な操作によりFiberErrorがスローされ、catchブロックで例外が捕捉されます。catchブロック内では、捕捉した例外オブジェクトに対して$e->getLine()を呼び出すことで、実際にFiberErrorが発生した$fiber->resume();の行番号を取得し、出力しています。この機能は、プログラムのエラー箇所を迅速に特定し、デバッグを行う際に非常に役立ちます。

このサンプルコードは、PHP 8.1以降で導入されたFiber（ファイバー）という非同期処理に関わる機能で発生するFiberError例外の扱い方を示しています。FiberはPHPの比較的新しい概念のため、初心者はまず基本的なtry-catchによる例外処理の仕組みを理解することが重要です。getLine()メソッドは、例外がスローされたソースコードの正確な行番号を返します。これはデバッグ時に問題発生箇所を特定するのに非常に役立ちますが、行番号はあくまでファイル内の物理的な位置であり、論理的なエラーの原因を直接示すものではない点にご留意ください。プログラムの安定性を保つため、予期せぬエラーは必ずtry-catchブロックで適切に捕捉し、処理することが推奨されます。