寻找可将OpenAPI Schema与Symfony控制器分离的Bundle方案

1. ApiPlatform Core #

• 作为Symfony生态中最成熟的API开发框架之一，完全支持将OpenAPI Schema与控制器分离：可通过config/api_platform/resources.yaml等配置文件定义API资源、Schema规则，无需在控制器或实体中嵌入注解。
• 自动生成符合OpenAPI规范的文档，内置Swagger UI和ReDoc界面；同时支持自动生成API路由，也可手动关联自定义控制器与配置好的Schema。
• 社区活跃度高、文档完善，兼容最新Symfony版本，是大规模API开发的首选方案。

2. 新版NelmioApiDocBundle #

• 若你之前使用的是旧版本，新版已支持通过yaml配置文件单独定义OpenAPI Schema，并关联到指定控制器路由，实现Schema与控制器的解耦。
• 可通过config/packages/nelmio_api_doc.yaml或独立yaml文件编写Schema，配合路由配置绑定到对应控制器方法；既保留原有注解能力，也支持纯配置文件模式。
• 作为老牌API文档工具，稳定性与兼容性有保障，社区用量大。

3. zircote/swagger-php（Symfony集成方案） #

• 这是一款成熟的OpenAPI生成库，虽非Symfony原生Bundle，但可通过简单配置实现集成：将Schema写在独立yaml文件中，通过命令行或事件监听生成OpenAPI文档，同时关联控制器路由。
• 支持完整的OpenAPI 3.x规范，灵活性极强，适合需要高度自定义Schema的场景；若需Bundle封装，也可基于它快速实现自定义Bundle，或使用社区维护的集成版本。

内容的提问来源于stack exchange，提问作者mrnavrc