mirror of
https://github.com/retailcrm/NelmioApiDocBundle.git
synced 2025-02-02 23:59:26 +03:00
78664ef9ec
* Initial pass for OA3 upgrade * Fix Util Tests * Fix first batch of Unit Tests. Up to Model * Another batch of fixed tests * Update annotations * Convert Model & Property Describers * Update tests, Fix RouteDescribers, FIx additional bugs * Another batch of updates * Another batch of fixed Functional Tests * Fix FunctionalTest tests * Fix Bazinga Tests * FIx FOS Rest * Fix JMS TEsts & describers * Fix all Tests * Fix few stuff from own CR * CS Fixes * CS Fixes 2 * CS Fixes 3 * CS Fixes 4 * Remove collection bug * Updates after first CRs * CS * Drop support for SF3 * Update the docs * Add an upgrade guide * misc doc fixes * Configurable media types * Code Style Fixes * Don't use ::$ref for @Response and @RequestBody * Fix upgrading guide * Fix OA case Co-authored-by: Filip Benčo <filip.benco@websupport.sk> Co-authored-by: Guilhem Niot <guilhem.niot@gmail.com> Co-authored-by: Mantis Development <mantis@users.noreply.github.com>
93 lines
2.4 KiB
Markdown
93 lines
2.4 KiB
Markdown
CHANGELOG
|
|
=========
|
|
|
|
4.0.0
|
|
-----
|
|
* Added support of OpenAPI 3.0. The internals were completely reworked and this version introduces BC breaks.
|
|
|
|
3.3.0
|
|
-----
|
|
|
|
* Usage of Google Fonts was removed. System fonts `serif` / `sans` will be used instead.
|
|
This can lead to a different look on different operating systems.
|
|
You can [re-add Google Fonts again manually by overriding the template](https://symfony.com/doc/current/bundles/NelmioApiDocBundle/faq.html#re-add-google-fonts).
|
|
|
|
* The Twig template for the Swagger UI now contains blocks to make it easier to overwrite certain parts.
|
|
See the [official documentation](https://symfony.com/doc/current/bundles/NelmioApiDocBundle/customization.html) how to do this.
|
|
|
|
3.2.0 (2018-03-24)
|
|
------------------
|
|
|
|
* Add a documentation form extension. Use the ``documentation`` option to define how a form field is documented.
|
|
* Allow references to config definitions in controllers.
|
|
* Using `@Model` implicitely in `@SWG\Schema`, `@SWG\Items` and `@SWG\Property` is deprecated. Use `ref=@Model()` instead.
|
|
|
|
Before:
|
|
```php
|
|
/**
|
|
* This was considered as an array of models.
|
|
*
|
|
* @SWG\Property(@Model(type=FooClass::class))
|
|
*/
|
|
```
|
|
|
|
After:
|
|
```php
|
|
/**
|
|
* For an individual object:
|
|
* @SWG\Property(ref=@Model(type=FooClass::class))
|
|
*
|
|
* For an array:
|
|
* @SWG\Property(type="array", @SWG\Items(ref=@Model(type=FooClass::class)))
|
|
*/
|
|
```
|
|
|
|
Config
|
|
* `nelmio_api_doc.areas` added support to filter by host patterns.
|
|
|
|
```yml
|
|
nelmio_api_doc:
|
|
areas: [ host_patterns: [ ^api\. ] ]
|
|
```
|
|
|
|
* Added dependency for "symfony/options-resolver:^3.4.4|^4.0"
|
|
|
|
3.1.0 (2018-01-28)
|
|
------------------
|
|
|
|
* Added Symfony Validator constraints support
|
|
|
|
Symfony Forms
|
|
* Support for boolean checkbox
|
|
* Support for integer
|
|
|
|
JMS Serializer
|
|
* Support JMS `int` (alias for `integer`)
|
|
* Also process phpdoc annotations
|
|
|
|
SwaggerPHP
|
|
* Handle `enum` and `default` properties from SwaggerPHP annotation
|
|
* Support `@Security` annotations
|
|
|
|
Config
|
|
* `nelmio_api_doc.routes` has been replaced by `nelmio_api_doc.areas`. Please update your config accordingly.
|
|
|
|
Before:
|
|
```yml
|
|
nelmio_api_doc:
|
|
routes: [ path_patterns: [ /api ] ]
|
|
```
|
|
|
|
After:
|
|
```yml
|
|
nelmio_api_doc:
|
|
areas: [ path_patterns: [ /api ] ]
|
|
```
|
|
|
|
3.0.0 (2017-12-10)
|
|
------------------
|
|
|
|
Large refactoring introducing `zircote/swagger-php` for swagger annotations.
|
|
|
|
See UPGRADE-3.0.md for upgrading instructions.
|