「効かない！」依存性注入（DI）を活用したAPI Platformのエラーハンドリング奮闘記 / "It’s Not Working!" A Struggle with Error Handling in API Platform using DI

PHPerKaigi 2026のLT発表のスライドです

---

フレームワーク同士の噛み合わせによって、カスタムしたい箇所がうまくカスタムできずモヤモヤしたことはありますでしょうか？

私は「例外時のAPI Platformからのレスポンスをカスタムしたいのに、Laravelの標準エラーハンドラに書いても効かない〜〜〜！」とAPI Platform for Laravelの例外処理に悩まされました。
これは、API Platformが内部で利用するSymfonyのコンポーネントが、Laravelの例外処理よりも手前でレスポンスを生成し、意図的に上書きしているためです。

そこでフレームワークのソースコードを確認して勝ち取った解決策を共有します。それは、複雑な設定変更ではなく、たった一つのサービスプロバイダへの追記によるものです。
ポイントはフレームワークのErrorHandlerクラスをカスタムクラスで上書きすることでした。

このLTでは、フレームワークの制御の意図的な優先問題を解決する実例とDI（依存性注入）がいかにフレームワークを裏側から制御する武器になるかをお話しします！

Transcript

1. 「効かない！」 依存性注入（DI）を活用した API Platformの エラーハンドリング奮闘記 まきまき 2026/03/22 PHPerKaigi 2026 1
2. 2 フレームワークのカスタムしたい箇所が 思い通りにカスタムできず モヤモヤしたことはありますか？
3. 3 API Platform初心者の私が API Platformでうまくカスタムできず、 モヤモヤした話をします
4. まきまき　 　　　　　　　 @_mkmk884 愛媛→京都→小田原→横浜 コネヒト株式会社　Webエンジニア PHPカンファレンス小田原 2026/04/11 PHPカンファレンス愛媛 2026/10/03 のコアスタッフ 4
5. API Platform 5 • WebAPIの開発に特化した PHP向けのフルスタックフレームワーク • Symfonyコンポーネントをベースとしている • アトリビュートを1行記載するだけでREST APIを作成可能 • 仕様（OpenAPI/Swagger）やドキュメント が自動生成される
6. やっていたこと 6 • Laravel + API Platform for Laravel を用いて開発 ◦ Laravelプロジェクトの上にAPI Platformの機能を 乗せることができる • エンドポイントを叩かれたら、処理を実行して結果を 返却する役割
7. やりたかったこと 7 すべてのエンドポイントの 例外時のレスポンスを 3種類に固定したい
8. やりたかったこと 8 クライアント側の バリデーションエラー等 システム内部の データ整合性エラー等 DB接続エラー、 APIタイムアウト等
9. 9 Laravelのプロジェクトだから Laravelの例外ハンドラーに 書こう 💡
10. やってみた① withExceptionsに例外を記載 10 bootstrap/app.php
11. やってみた① withExceptionsに例外を記載 11 bootstrap/app.php Laravel標準の汎用例外ハンドラー アプリケーション全体の 例外ハンドリング動作を一括設定できる
12. やってみた① withExceptionsに例外を記載 12 bootstrap/app.php カスタムしたい 例外処理を入れた
13. 13 効かない！ 💧 withExceptionsに記載した内容で返されてない…
14. 14 API Platformからレスポンスが 出ていくところに割り込みで書こう 💦
15. やってみた② 例外処理のリスナーを設定する 15 カスタムしたい例外処理 のリスナーを作成
16. やってみた② 例外処理のリスナーを設定する 16 API Platform内部で 用いているSymfony に対して割り込み
17. やってみた② 例外処理のリスナーを設定する 17 カスタムしたい 例外処理を入れた
18. やってみた② 例外処理のリスナーを設定する 18 api/php/app/Providers/EventServiceProvider.php api/php/bootstrap/providers.php 作成したリスナー を設定
19. 19 💧 Listenerに記載した内容で返されてない… 💧 効かない〜〜〜！
20. API Platformのソースコードを確認 20 ※ 当時のソースコード（現在は少し変わってます） ApiPlatformDeferredProvider.php
21. API Platformのソースコードを確認 21 ※ 当時のソースコード（現在は少し変わってます） ApiPlatformDeferredProvider.php ExceptionHandler クラスに従う
22. API Platformのソースコードを確認 22 ※ 当時のソースコード（現在は少し変わってます） API Platformの ErrorHandlerクラス がラップ ApiPlatformDeferredProvider.php
23. API Platformのソースコードを確認 23 ※ 当時のソースコード（現在は少し変わってます） Decorator パターン 既存の例外ハンドラ をラップすることで 拡張している ApiPlatformDeferredProvider.php
24. 24 これを自作に置き換えれば……！ 💡 💡 ApiPlatformDeferredProvider.php
25. 25 これはｯ！DIコンテナの出番だー！ 💡 💡 ApiPlatformDeferredProvider.php
26. 例外ハンドラーを作成して注入 26
27. 例外ハンドラーを作成して注入 27 ErrorHandlerを継承
28. 例外ハンドラーを作成して注入 28 カスタムしたい例外 を入れる
29. 例外ハンドラーを作成して注入 29 ErrorHandlerを継承 した独自ハンドラー を作成
30. 例外ハンドラーを作成して注入 30 例外処理の主導権を 自作クラスが持つ ことができる Laravel標準の ExceptionHandlerを 自作クラスへ差し替え
31. 31 \ レスポンス /
32. 32 やりたい拡張ができた！！！
33. 【学び】 フレームワークと”想定外”の付き合い方 33 • ドキュメントにないカスタムは ソースコードから読み解くしかない • フレームワークは内部で使っている技術（Laravel/Symfony） の標準機能を上書き・拡張することで、独自処理を している → 多層構造を理解する必要がある
34. 【まとめ】拡張のポイントはDIコンテナの活用 34 • DIコンテナは、フレームワーク側が用意してくれている 重要な拡張ポイント • フレームワーク選定時は、DIコンテナで拡張できるかを 確認すると◎ • 大きく複雑なアプリケーションを破綻することなく、 どのような要望でもある程度叶えられる
35. こちらの本にも対処法が載ってます！！！ 35 API Platformを活用したPHPによる本格的なWeb API開発 / 金本 貴志 たつきちさん 今回の内容は 112〜114ページ に載っています ※本人に許諾いただきました