在开发 API 时，管理和操作 Swagger/OpenAPI 规范常常是一项复杂且耗时的任务。我曾在一个项目中遇到过这样的问题：需要频繁地修改和更新 Swagger 文档，手动操作不仅容易出错，还非常低效。最终，我通过 composer 安装了 exsyst/swagger 库，成功解决了这个问题，极大地提高了工作效率。
exsyst/swagger 是一个专为操作 Swagger/OpenAPI 规范设计的 php 库。通过这个库，我能够轻松地读取、修改和管理 Swagger 文档。使用 Composer 安装这个库非常简单，只需运行以下命令：
composer require EXSyst/Swagger
安装好后，我可以直接从文件中读取 Swagger 规范：
$swagger = Swagger::fromFile('api.json');
或者从数组中创建 Swagger 对象：
$swagger = new Swagger($array);
这个库提供了两个主要的集合：Paths 和 Definitions，它们都有一个类似的 API，使得操作变得非常直观。例如，我可以这样操作 Paths：
$paths = $swagger->getPaths(); $p = new Path('/user'); foreach ($paths as $path) { // 添加路径 $paths->add($a); // 检查和获取路径 if ($paths->has('/user') || $paths->contains($p)) { $path = $paths->get('/user'); } // 删除路径 $paths->remove('/user'); }
此外，exsyst/swagger 还提供了许多模型，比如 Path，这些模型的 API 设计得非常好，支持 ide 的自动完成功能，命名方案也与 OpenAPI 规范一致，非常易于使用。
使用 exsyst/swagger 库后，我不再需要手动编辑 Swagger 文档，所有操作都可以在代码中完成，既提高了效率，又减少了出错的可能性。更重要的是，这个库的维护者非常积极，鼓励社区贡献，如果你有好的改进建议，可以随时 fork 项目并提交 pull request。
总的来说，exsyst/swagger 通过 Composer 的简单安装和使用，解决了我在 API 开发中遇到的 Swagger 管理难题，极大地提升了我的工作效率。如果你也在为 Swagger/OpenAPI 规范的管理苦恼，不妨尝试一下这个库。
