NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #606 most downloaded on Packagist
Generates documentation for your REST API from attributes
Latest stable
v5.13.2
Last release 23 days ago
30 Oct 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
210 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
abstract Choice callback handling during schema generation
Your coding agent can read these notes before it upgrades. Set up the MCP server →
symfony-constraints: describe #[Assert\Choice] with match: false as an exclusion
deps: bump @scalar/api-reference from 1.67.0 to 1.68.0 in /utils
model-registry: reserve generated schema names against nested registrations
harden OpenAPI generation for FrankenPHP / long-lived workers
Add support for the query http method
deps: bump @scalar/api-reference from 1.55.3 to 1.57.5 in /utils
config: root vendor extensions get ignored
deps: bump @scalar/api-reference from 1.52.0 to 1.52.1 in /utils
exclude BackedEnum from TranslatablePropertyDescriber (#2692) (2c40b2e), closes #2507
deps: bump @stoplight/elements from 9.0.15 to 9.0.16 in /utils
LegacyType deprecation warning in Configuration
#[MapRequestPayload] & #[MapUploadedFile] combined on same route (#2689) (4ff48e7)composer: conflict for symfony/property-info versions
config: set type_info default correctly in Symfony 8
Add support for static callbacks in Symfony choice constraints
deps: bump @stoplight/elements from 9.0.12 to 9.0.13 in /utils
SplObjectStorage: SplObjectStorage::detach() is deprecated since 8.5, use method SplObjectStorage::offsetUnset() instead
configuration: validate type_info option on Symfony 6
trigger_deprecation: incorrect & missing trigger_deprecation in Model class
swagger-php 5.7.0 compatatiblity
Implement Ulid type description in ClassDescriber
version number in triggered deprecation
config: migrate xml to php config
deps: bump @stoplight/elements from 9.0.6 to 9.0.8 in /utils
deps: bump swagger-ui-dist from 5.28.1 to 5.29.0 in /utils
ModelRegistry: ensure first registered alternative name is used
Model: Allow customizing the name of generated schemas.
deps: bump swagger-ui-dist from 5.27.1 to 5.28.0 in /utils
chore(deps): bump swagger-ui-dist from 5.25.3 to 5.27.1 in /utils by @dependabot[bot] in https://github.com/nelmio/NelmioApiDocBundle/pull/2525
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.4.0...v5.5.0
feat(#2486): properly describe multiple file upload by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2511
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.3.1...v5.4.0
chore(deps): bump stefanzweifel/git-auto-commit-action from 5 to 6 by @dependabot in https://github.com/nelmio/NelmioApiDocBundle/pull/2500
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.3.0...v5.3.1
docs: add community projects by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2493
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.2.1...v5.3.0
chore: Update README.md by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2490
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.2.0...v5.2.1
Fixed a bug where using abstract controllers would ignore various attributes like #[OA\Tag] & #[Security] on child classes
feat: generate security documentation by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2445
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.1.0...v5.2.0
Made it possible to automatically generate security definitions based on the #[IsGranted] attribute.
nelmio_api_doc:
# ...
areas:
default:
security:
MyBearerScheme:
type: 'http'
scheme: 'bearer'
feat(#2485): Configure operationId generation method by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2489
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.0.2...v5.1.0
Made it possible to configure how operation ids are generated.
nelmio_api_doc:
operation_id_generation: always_prepend
Possible values: always_prepend, conditionally_prepend, no_prepend or enum instance of Nelmio\ApiDocBundle\Describer\OperationIdGeneration
ci: stale by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2463
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.0.1...v5.0.2
fix: missing tab in doc by @iBast in https://github.com/nelmio/NelmioApiDocBundle/pull/2455
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.0.0...v5.0.1
chore: [5.x] remove deprecations by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2388
@Symfony:risky ruleset by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2397Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v4.38.1...v5.0.0
refactor: do not pass deprecated groups argument to PropertyDescriber by @herndlm in https://github.com/nelmio/NelmioApiDocBundle/pull/2451
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.0.0-beta6...v5.0.0-beta7
chore: cleanup Areas annotation by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2431
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.0.0-beta5...v5.0.0-beta6
fix: deprecation warning for usage of "tagged" by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2429
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.0.0-beta4...v5.0.0-beta5
chore: [5.x] remove deprecations by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2388
@Symfony:risky ruleset by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2397Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v4.35.0...v5.0.0-beta4
chore: [5.x] remove deprecations by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2388
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.0.0-beta2...v5.0.0-beta3
ci: 5.x phpunit ci fix by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2374
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v5.0.0-beta1...v5.0.0-beta2
Upgrade notes: https://github.com/nelmio/NelmioApiDocBundle/blob/v5.0.0-beta1/UPGRADE-5.0.md
Upgrade notes: https://github.com/nelmio/NelmioApiDocBundle/blob/v5.0.0-beta1/UPGRADE-5.0.md
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v4.32.2...v5.0.0-beta1
swagger-ui: dark mode ui background color Backport [#2665 to 4.x]
SplObjectStorage: SplObjectStorage::detach() is deprecated since 8.5, use method SplObjectStorage::offsetUnset() instead Backport [#2634 to 4.x]
configuration: validate type_info option on Symfony 6
remove unused TypesTrait Backport [#2588 to 4.x]
fix(MapQueryParameter): convert pcre regex to ecma by @xavierleune in https://github.com/nelmio/NelmioApiDocBundle/pull/2435
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v4.38.1...v4.38.2
docs(4.x): update references from master to 4.x by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2453
master to 4.x by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2453Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v4.38.0...v4.38.1
refactor: do not pass deprecated groups argument to PropertyDescriber by @herndlm in https://github.com/nelmio/NelmioApiDocBundle/pull/2451
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v4.37.1...v4.38.0
#[Ignore] attribute that allows a property to be excluded from the generated schema.<?php
use Nelmio\ApiDocBundle\Attribute\Ignore;
class Foo
{
#[Ignore]
private string $ignoredProperty;
}
#[MapUploadedFile] symfony controller argument attributefix: stoplight ui height by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2444
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v4.37.0...v4.37.1
feat: stoplight as an UI option by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2443
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v4.36.2...v4.37.0
docs: update README shields by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2432
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v4.36.1...v4.36.2
chore: cleanup Areas annotation by @DjordyKoert in https://github.com/nelmio/NelmioApiDocBundle/pull/2431
Full Changelog: https://github.com/nelmio/NelmioApiDocBundle/compare/v4.36.0...v4.36.1
value with a list of strings to the Areas annotation/attribute is deprecated. Pass the list of strings directly.-#[Areas(properties: ['value' => ['foo', 'bar']])]
+#[Areas(properties: ['foo', 'bar'])]
-#[Areas(['value' => ['foo', 'bar']])]
+#[Areas(['foo', 'bar'])]
One column per quarter.