はじめに：Fiberがもたらす「制御フローの非連続性」と例外の闇
PHP 8.1で導入されたFiber（ファイバー）は、我々に「スタックフルな協占的マルチタスク（Coroutine）」という強力な武器をもたらした。従来の`Generator`による擬似的な非同期処理とは異なり、コールスタックの任意の深さから処理を中断（Suspend）し、任意のタイミングで再開（Resume）できる。
しかし、この「制御フローの非連続性」は、PHPアプリケーションの最も根幹にあるエラーハンドリングの前提を根本から破壊する。
通常の同期処理であれば、例外（`Throwable`）はコールスタックを巻き戻しながら（Stack Unwinding）、最も内側の`try-catch`ブロックへと伝播する。しかし、Fiber内部でスローされた例外が捕捉されなかった場合、その例外は親コンテキスト（Fiberを起動した側）へとどう伝わるのか？ さらに、中断・再開を繰り返した非同期コンテキストにおいて、失われたスタックトレースをどう復元し、デバッグ地獄から生還するのか。
本稿では、Zend Engineの内部挙動を踏まえつつ、Fiberの例外伝播メカニズムと、実務のプロダクション環境で破綻しない堅牢なエラーハンドリング設計を解き明かす。
—
1. Fiber内部における例外のライフサイクルと伝播メカニズム
内部で何が起きているのか？（Zend VMの視点）
PHPのFiberは、Cレベルで独自のコールスタックを割り当てて実行される。Fiberの内部で例外がスローされ、それがそのFiberのスコープ内で捕捉されなかった場合、Zend VMはそのFiberの実行コンテキストを強制的に終了状態（Terminated）にする。
ここで重要なのは、「例外は自動的に親へ飛んでこない」という点である。
`Fiber::start()` あるいは `Fiber::resume()` を呼び出した親コンテキスト側では、その戻り値や例外のキャッチ方法を誤ると、未処理例外（Uncaught Exception）としてプロセス全体をクラッシュさせるか、イベントループを静かに沈黙させる。
Fiberのライフサイクルにおいて、例外は次のように振る舞う。
1. Fiber内でのスロー: `Fiber::suspend()` の内外を問えず、例外が発生するとFiberの実行状態は即座に `isTerminated() === true` となる。
2. 例外のキャプチャ: Fiberの外部（親コンテキスト）で `$fiber->resume()` または `$fiber->start()` を実行したまさにその瞬間、呼び出し元コンテキストのコールスタック上で その例外がPHPの例外として再スロー（Re-throw）される。
つまり、親コンテキスト側は、必ず `resume()` の呼び出しを `try-catch` で囲む必要がある。これを怠ると、非同期タスクの裏側で起きた致命的なバグが握りつぶされるか、アプリケーション全体を予期せぬダウンに追い込むことになる。
—
2. スタックトレースの断絶と「偽りのトレース」の罠
Fiberをデバッグする際、エンジニアが直面する最大の絶望は「スタックトレースの分断」である。
Fiber内で発生した例外を親コンテキストで `catch` した際、その例外オブジェクトが持つ `getTrace()` は、Fiberが最後に中断した瞬間から、例外発生源までのトレースしか保持していないことが多い。あるいは、Fiberの再開と中断が複雑に入り組んだイベントループ上では、親側の「どこからそのFiberをキックしたのか（呼び出し元コンテキスト）」という情報が完全に抜け落ちる。
これに対処するためには、例外の伝播時にトレースの合成（Trace Merging / Wrapping）を行う必要がある。
—
3. 【実装例】実務に耐えうる堅牢なFiberタスクランナーと例外伝播設計
ここでは、非同期I/Oやタスクキューを想定し、Fiber内で発生した例外を安全に捕捉し、親コンテキストへ文脈（Context）を保ったままスタックトレースを結合して伝播させる、プロダクション品質のコードを示す。
declare(strict_types=1);
namespace App\Concurrency;
use Throwable;
use Fiber;
use Exception;
/
- 非同期ファイバータスクを安全に管理・実行するエンベロープクラス
/
class SafeFiberTask
{
private Fiber $fiber;
private mixed $result = null;
private ?Throwable $exception = null;
private bool $isStarted = false;
/
- @param callable(): mixed $task
/
public function __construct(private readonly callable $task, private readonly string $taskName = ‘UnnamedTask’)
{
$this->fiber = new Fiber(function (): void {
try {
// タスクを実行し、結果を保持
$this->result = ($this->task)();
} catch (Throwable $e) {
// Fiber内部で発生した例外をキャプチャし、親への伝播用に保持
// ここでスタックトレースの断絶を防ぐため、カスタム例外でラップする戦略も有効
$this->exception = new FiberExecutionException(
sprintf(“Fiberタスク ‘%s’ の実行中に例外が発生しました: %s”, $this->taskName, $e->getMessage()),
0,
$e
);
}
});
}
/
- ファイバーの初回起動
/
public function start(mixed …$args): mixed
{
if ($this->isStarted) {
throw new LogicException(“タスクは既に開始されています。”);
}
$this->isStarted = true;
$this->fiber->start(…$args);
return $this->handlePostExecution();
}
/
- ファイバーの再開（Resume）
/
public function resume(mixed $value = null): mixed
{
if (!$this->fiber->isSuspended()) {
throw new LogicException(“ファイバーが中断状態にないため、再開できません。”);
}
$this->fiber->resume($value);
return $this->handlePostExecution();
}
public function isSuspended(): bool
{
return $this->fiber->isSuspended();
}
public function isTerminated(): bool
{
return $this->fiber->isTerminated();
}
/
- 実行後の状態を評価し、例外があれば親コンテキストへ再スローする
/
private function handlePostExecution(): mixed
{
// Fiber内で例外がキャプチャされていた場合、親コンテキストで爆発させる
if ($this->exception !== null) {
$ex = $this->exception;
// 参照をクリアしてメモリリーク（循環参照）を防ぐ
$this->exception = null;
throw $ex;
}
return $this->result;
}
}
/
- Fiber内の例外専用のラップ例外クラス
/
class FiberExecutionException extends Exception
{
public function __construct(string $message = “”, int $code = 0, ?Throwable $previous = null)
{
parent::__construct($message, $code, $previous);
}
}
// ==========================================
// 使用例（イベントループの模擬実行）
// ==========================================
// ダミーの非同期HTTPリクエストを模したタスク
$taskA = new SafeFiberTask(function () {
echo “[Task A] 開始\n”;
// 何らかの処理の途中でサスペンド
$data = Fiber::suspend(‘WAITING_FOR_DB’);
echo “[Task A] 再開データ受け取り: {$data}\n”;
// 意図的なバグ（例外の発生）
if (true) {
throw new RuntimeException(“データベース接続がタイムアウトしました。”);
}
return “Task A 完了”;
}, ‘API-Fetch-Task’);
// イベントループのシミュレーション
try {
echo “— メインループ開始 —\n”;
// タスク起動
$suspendValue = $taskA->start();
echo “メインスレッド: タスクが中断しました. 理由: {$suspendValue}\n”;
// I/O完了を待ってレジューム
$taskA->resume(“User-Data-OK”);
} catch (FiberExecutionException $e) {
// 親コンテキストでの堅牢なエラーハンドリング
echo “\n[ERROR] 捕捉された非同期例外:\n”;
echo “メッセージ: ” . $e->getMessage() . “\n”;
echo “— 内部例外（Original Trace） —\n”;
echo $e->getPrevious()?->getTraceAsString() . “\n”;
// 本番環境ではここで適切なログ出力、メトリック送信、トランザクションのロールバックを行う
}
この設計が実務において極めて堅牢である理由
1. 循環参照とメモリリークの防止:
PHPの例外オブジェクト（`Throwable`）は、スタックトレースの中に多くの変数やオブジェクトの参照を抱え込みやすい。Fiberと例外を密結合させると、Zend EngineのGC（ガベージコレクタ）が回収しきれない循環参照メモリリークを引き起こす原因になる。上記の `SafeFiberTask` では、例外の送出時に内部プロパティを即座に `null` にクリアすることで、メモリフットプリントを最小限に抑えている。
2. 例外のコンテキスト保持 (`$previous`):
`FiberExecutionException` を通してラップすることで、元の例外（`RuntimeException`）を `$previous`（前回の例外）として保持しつつ、どのFiberタスク（`taskName`）で起きたものかを親コンテキストへ正確に伝える。これにより、ログ解析時のトレーサビリティが劇的に向上する。
—
4. チーフアーキテクトからの警鐘：設計上のアンチパターン
最後に、コードレビューの現場で頻繁に目にする、Fiberを用いた非同期処理の「致命的なアンチパターン」を指摘しておく。
アンチパターン1: `try-catch` のスコープをFiberの境界外に置く罠
// 危険なコード例
try {
$fiber = new Fiber(function() {
// ここで起きた例外を、この外側のtryで拾えると誤認しやすい
some_risky_operation();
});
$fiber->start();
} catch (Throwable $e) {
// Fiber::start() を呼んだ時点で例外が出なければ、
// 実際にFiber内部で非同期に処理が進んだ後に起きた例外はここではキャッチされない！
}
解説: `Fiber::start()` はFiberの「初回実行」をキックするに過ぎない。Fiber内部で `suspend()` を経由した後の非同期処理の継続中に発生した例外は、`start()` ではなく、後続の `resume()` の呼び出し時に初めて表面化する。常に `resume()` を呼び出すラッパー側でハンドリングを完結させなければならない。
アンチパターン2: ログとトレースの欠損による「ブラックボックス化」
非同期処理は「いつ、どこで、どのリクエストの文脈で動いているか」がロストしやすい。グローバルなステートに依存したFiberの書き方をすると、並行処理（Concurrent）を走らせた瞬間に、あるリクエストの例外トレースに別のリクエストの変数が混ざり込むといった深刻なバグ（データ競合・汚染）を招く。
Fiber内で処理を行う際は、必ずリクエストスコープやコンテキストを完全にカプセル化したクロージャとして渡し、エラー発生時はそのコンテキスト情報を例外メッセージやログコンテキストに付与して出力する設計を徹底してほしい。
—
おわりに
PHPのFiberは、もはや「おもちゃの機能」ではない。正しく使いこなせば、従来のBlocking I/Oモデルに縛られたPHPアプリケーションの限界を突破する強力な非同期エンジンとなる。
しかし、その裏側にあるZend VMのスタック管理、例外伝播のライフサイクル、そしてメモリ管理のルールを無視すれば、アプリケーションは一瞬でデバッグ不能なブラックボックスと化すだろう。
「なぜこの例外はここでキャッチされなければならないのか」「このトレースはどこから繋がっているのか」。コードの1行1行にエンジニアとしての哲学とロジックを宿し、堅牢で美しい非同期Webシステムを構築してほしい。