NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #603 most downloaded on Packagist
Generates documentation for your REST API from attributes
Last release 18 days ago
14 Sep 2026
Ships fairly regularly
a new release about every 3 weeks
Most releases are documented
notes for 44 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
207 releases · first in 2012
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Added support of OpenAPI 3.0. The internals were completely reworked and this version introduces BC breaks.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Added @SerializedName annotation support and name converters when using Symfony >= 4.2.
@SerializedName annotation support and name converters when using Symfony >= 4.2.@SWG annotations support at methods level in modelsNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
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. Y
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.
The Twig template for the Swagger UI now contains blocks to make it easier to overwrite certain parts. See the official documentation how to do this.
Nothing published for this version
Using @Model implicitly in @SWG\Schema, @SWG\Items and @SWG\Property is deprecated. Use ref=@Model() instead.
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 implicitly in @SWG\Schema, @SWG\Items and @SWG\Property is deprecated. Use ref=@Model() instead.
Before:
/**
* This was considered as an array of models.
*
* @SWG\Property(@Model(type=FooClass::class))
*/
After:
/**
* 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.
nelmio_api_doc:
areas: [ host_patterns: [ ^api\. ] ]
Added dependency for "symfony/options-resolver:^3.4.4|^4.0"
Added Symfony Validator constraints support
Symfony Forms
JMS Serializer
int (alias for integer)SwaggerPHP
enum and default properties from SwaggerPHP annotation@Security annotationsConfig
nelmio_api_doc.routes has been replaced by nelmio_api_doc.areas. Please update your config accordingly.
Before:
nelmio_api_doc:
routes: [ path_patterns: [ /api ] ]
After:
nelmio_api_doc:
areas: [ path_patterns: [ /api ] ]
Large refactoring introducing zircote/swagger-php for swagger annotations.
Large refactoring introducing zircote/swagger-php for swagger annotations.
See UPGRADE-3.0.md for upgrading instructions.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →