mirror of https://github.com/retailcrm/NelmioApiDocBundle.git synced 2025-04-01 21:06:15 +03:00

Generates documentation for your REST API from annotations

Find a file

Encre Informatique 4148dfda25 fixed : add doc blocks to silence Symfony deprecations (#1922 ) * fixed : add doc blocks to silence Symfony deprecations Symfony 5.4 returning deprecations about ``` User Deprecated: Method "Twig\Extension\ExtensionInterface::getFunctions()" might add "array" as a native return type declaration in the future. Do the same in implementation "Nelmio\ApiDocBundle\Render\Html\GetNelmioAsset" now to avoid errors or add an explicit @return annotation to suppress this message. ``` * fixed : native hint		2021-12-11 13:58:33 +01:00
.github/workflows	Change the management of the cache of composer	2021-06-07 18:52:44 +02:00
Annotation	Support oauth2 scopes in Security annotation	2021-01-26 19:08:53 +01:00
Command	Enable overriding server url for yaml and json export from console	2021-07-29 12:22:54 +02:00
Controller	Keep server_url from Request only in RenderOpenApi	2021-07-29 12:11:10 +02:00
DependencyInjection	Merge branch '3.x'	2021-11-04 00:06:42 +01:00
Describer	Issue 1848 operation id by route name (#1907 )	2021-11-22 20:18:16 +01:00
Exception	Update outdated swagger annotations namespace (#1898 )	2021-11-03 23:55:56 +01:00
Form/Extension	Allow to not document form types fields (#1752 )	2020-12-02 15:38:38 +01:00
Model	Fix usage of getCollectionValueTypes and getCollectionKeyTypes (#1910 )	2021-11-30 13:06:32 +01:00
ModelDescriber	Always provide a context to swagger-php (#1860 )	2021-08-17 21:52:21 +02:00
OpenApiPhp	Always provide a context to swagger-php (#1860 )	2021-08-17 21:52:21 +02:00
PropertyDescriber	Fix Symfony\Component\PropertyInfo\Type::getCollectionValueType() deprecation notice for symfony >=5.3	2021-08-18 16:12:47 +03:00
Render	fixed : add doc blocks to silence Symfony deprecations (#1922 )	2021-12-11 13:58:33 +01:00
Resources	Add Location of Original Template (#1897 )	2021-11-04 00:13:42 +01:00
RouteDescriber	CS	2021-04-23 15:21:04 +02:00
Routing	Merge branch '3.x'	2021-11-04 00:06:42 +01:00
Tests	Fix usage of getCollectionValueTypes and getCollectionKeyTypes (#1910 )	2021-11-30 13:06:32 +01:00
Util	Supports reflection for routes configured in PHP files. (#1701 )	2020-08-11 16:46:05 +02:00
.gitattributes	Exclude development files from dist package	2020-09-28 10:36:17 -03:00
.gitignore	Add php 8 support (#1745 )	2020-12-10 21:59:36 +01:00
.php_cs.dist	Fix build travis	2019-11-20 12:15:00 +01:00
.styleci.yml	Update StyleCI config	2020-08-06 10:25:35 +02:00
.symfony.bundle.yaml	Change in a config file	2021-03-23 14:29:59 +01:00
ApiDocGenerator.php	Always provide a context to swagger-php (#1860 )	2021-08-17 21:52:21 +02:00
CHANGELOG.md	Release version 3.7	2020-08-12 11:06:17 +02:00
composer.json	Fix #1885 update psr/log and psr/container (#1892 )	2021-11-03 23:57:21 +01:00
CONTRIBUTING.md	Add php 8 support (#1745 )	2020-12-10 21:59:36 +01:00
LICENSE	Change the vendor to "Nelmio"	2016-12-29 12:09:26 +01:00
NelmioApiDocBundle.php	Add areas support (#1169 )	2018-01-05 13:08:02 +01:00
phpunit	Add php 8 support (#1745 )	2020-12-10 21:59:36 +01:00
phpunit.bat	Fix Declaration must be compatible error with tests (#1638 )	2020-05-31 15:16:51 +02:00
phpunit.xml.dist	Let PHPUnit fail on warnings and risky tests	2021-03-14 17:18:13 +01:00
README.md	Merge branch '3.x'	2020-12-29 10:30:06 +01:00
update-js.sh	Include map files	2017-06-22 21:22:10 +02:00
UPGRADE-3.0.md	Add exceptions in the upgrading command to warn about the requirement to run it on 2.x (#1501 )	2019-04-11 20:54:16 +02:00
UPGRADE-4.0.md	Add support for compound properties (#1651 )	2020-06-16 13:11:53 +02:00

README.md

NelmioApiDocBundle

The NelmioApiDocBundle bundle allows you to generate a decent documentation for your APIs.

Migrate from 3.x to 4.0

To migrate from 3.x to 4.0, follow our guide.

Version 4.0 brings OpenAPI 3.0 support. If you want to stick to Swagger 2.0, you should use the version 3 of this bundle.

Migrate from 2.x to 3.0

To migrate from 2.x to 3.0, follow our guide.

Installation

Open a command console, enter your project directory and execute the following command to download the latest version of this bundle:

composer require nelmio/api-doc-bundle

Documentation

Read the documentation on symfony.com

Contributing

See CONTRIBUTING file.

Running the Tests

Install the Composer dependencies:

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

Then run the test suite:

./phpunit

License

This bundle is released under the MIT license.