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

Copy
1<?php
2
3/**
4 * FiberError::getCode() の使用例を示す関数
5 *
6 * この関数は、意図的に FiberError を発生させ、
7 * catch した例外オブジェクトから getCode() メソッドを使って
8 * 例外コードを取得し、表示します。
9 *
10 * @return void
11 */
12function demonstrateFiberErrorCode(): void
13{
14    // Fiber がサポートされていない環境（PHP 8.1未満）では実行しない
15    if (!class_exists('Fiber')) {
16        echo 'このサンプルコードを実行するには PHP 8.1 以上が必要です。' . PHP_EOL;
17        return;
18    }
19
20    try {
21        // 簡単な処理を行う Fiber を作成
22        $fiber = new Fiber(function (): string {
23            // Fiber 内で処理を行い、値を返す
24            return 'Fiberが正常に実行されました。';
25        });
26
27        // Fiber を開始し、実行する
28        $result = $fiber->start();
29        echo $result . PHP_EOL;
30
31        // Fiber は既に終了しているため、再度 resume() を呼び出すと
32        // FiberError がスローされる
33        echo '終了したFiberを再度再開しようと試みます...' . PHP_EOL;
34        $fiber->resume();
35    } catch (FiberError $e) {
36        // FiberError をキャッチする
37        echo 'FiberErrorが発生しました！' . PHP_EOL;
38
39        // getCode() メソッドで例外コードを取得する
40        // 通常、明示的にコードが設定されていない場合、0が返される
41        $errorCode = $e->getCode();
42        
43        // 取得した例外コードとメッセージを表示する
44        echo '例外コード: ' . $errorCode . PHP_EOL;
45        echo '例外メッセージ: ' . $e->getMessage() . PHP_EOL;
46    }
47}
48
49// 関数を実行
50demonstrateFiberErrorCode();

PHPのFiberError::getCode()は、Fiberの操作でエラーが発生した際にスローされるFiberError例外オブジェクトから、エラーコードを取得するためのメソッドです。このメソッドは引数を取らず、戻り値として整数型（int）のエラーコードを返します。通常、エラーコードが明示的に設定されていない場合は0が返されます。

サンプルコードでは、意図的にFiberErrorを発生させる状況を再現しています。まず、Fiberを作成してstart()で一度正常に実行し、終了させます。その後、すでに終了したFiberに対してresume()メソッドを呼び出すことで、FiberErrorを発生させています。

try...catch構文によってこのエラーを捕捉し、catchブロック内で、受け取った例外オブジェクト（$e）に対してgetCode()を実行しています。これにより取得したエラーコードと、getMessage()で取得したエラーメッセージを画面に出力しています。このようにgetCode()を利用することで、発生したエラーの種類をプログラムで識別し、エラーに応じた処理を実装する際に役立ちます。