mrbulkinaleksey / api-doc-bundle

从注释生成您的REST API文档

维护者

详细信息

github.com/MrBulkinAleksey/NelmioApiDocBundle

安装次数: 2,053

类型:symfony-bundle

v4.6.2 2021-10-19 12:29 UTC

Requires

php: >=7.1.3
ext-json: *
doctrine/annotations: ^1.11
phpdocumentor/reflection-docblock: ^3.1|^4.4|^5.0
psr/cache: ^1.0|^2.0|^3.0
psr/container: ^1.0
psr/log: ^1.0
symfony/config: ^4.4|^5.0
symfony/console: ^4.4|^5.0
symfony/dependency-injection: ^4.4|^5.0
symfony/framework-bundle: ^4.4|^5.0
symfony/http-foundation: ^4.4|^5.0
symfony/http-kernel: ^4.4|^5.0
symfony/options-resolver: ^4.4|^5.0
symfony/property-info: ^4.4|^5.0
symfony/routing: ^4.4|^5.0
zircote/swagger-php: ^3.0

Requires (Dev)

api-platform/core: ^2.4
composer/package-versions-deprecated: 1.11.99.1
friendsofsymfony/rest-bundle: ^2.8|^3.0
jms/serializer: ^1.14|^3.0
jms/serializer-bundle: ^2.3|^3.0
sensio/framework-extra-bundle: ^4.4|^5.0|^6.0
symfony/asset: ^4.4|^5.0
symfony/browser-kit: ^4.4|^5.0
symfony/cache: ^4.4|^5.0
symfony/dom-crawler: ^4.4|^5.0
symfony/form: ^4.4|^5.0
symfony/phpunit-bridge: ^5.2
symfony/property-access: ^4.4|^5.0
symfony/serializer: ^4.4|^5.0
symfony/stopwatch: ^4.4|^5.0
symfony/templating: ^4.4|^5.0
symfony/twig-bundle: ^4.4|^5.0
symfony/validator: ^4.4|^5.0
willdurand/hateoas-bundle: ^1.0|^2.0

Suggests

api-platform/core: For using an API oriented framework.
friendsofsymfony/rest-bundle: For using the parameters annotations.
jms/serializer-bundle: For describing your models.
symfony/asset: For using the Swagger UI.
symfony/cache: For using a PSR-6 compatible cache implementation with the API doc generator.
symfony/form: For describing your form type models.
symfony/monolog-bundle: For using a PSR-3 compatible logger implementation with the API PHP describer.
symfony/serializer: For describing your models.
symfony/validator: For describing the validation constraints in your models.
twig/twig-bundle: For using the Swagger UI.
willdurand/hateoas-bundle: For extracting HATEOAS metadata.

Provides

None

Conflicts

symfony/framework-bundle: 4.2.7

Replaces

None

MIT efa83ca54eefb43e7af16a3c08e8b613d075fc79

documentation rest api doc

This package is auto-updated.

Last update: 2024-09-26 17:57:02 UTC

README

NelmioApiDocBundle 扩展包允许您为API生成良好的文档。

从 3.x 迁移到 4.0

要从 3.x 迁移到 4.0，请遵循我们的指南。

版本 4.0 带来了 OpenAPI 3.0 支持。如果您想坚持使用 Swagger 2.0，您应该使用此扩展包的 3.0 版本。

从 2.x 迁移到 3.0

要从 2.x 迁移到 3.0，请遵循我们的指南。

安装

打开命令行控制台，进入您的项目目录并执行以下命令以下载此扩展包的最新版本

composer require nelmio/api-doc-bundle

文档

在 symfony.com 上阅读文档

贡献

查看 CONTRIBUTING 文件。

运行测试

安装 Composer 依赖

git clone https://github.com/nelmio/NelmioApiDocBundle.git
cd NelmioApiDocBundle
composer update

然后运行测试套件

./phpunit

许可证

此扩展包在 MIT 许可证下发布。