Symfony + NelmioApiDocBundle を使ったスキーマ駆動開発 by おかしょい

PHP を使った Web アプリケーション開発において、多くの場合はサーバーサイドとクライアントサイドで実装が分離されるでしょう。

それらの結節点として、API 仕様を拠り所とするスキーマ駆動開発は

• サーバーサイドとクライアントサイドで独立して開発できる
• 仕様の認識齟齬を防げる
• 型安全に開発できる

といった観点から強力な手法となり得ます。

一方で仕組みを十分に整えないとその恩恵に与れないまま、煩雑さだけを導入してしまうことにもなりかねません。

このトークではスキーマ駆動開発の実践例のひとつとして Symfony と NelmioApiDocBundle の組み合わせを取り上げて

• NelmioApiDocBundle でできること
• 使う上での設定や周辺の設計
• 具体的な API の実装
• NelmioApiDocBundle でできないこと、他の選択肢と比較しての弱み

を解説します。