NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #346 most downloaded on Packagist
Generate interactive documentation for your RESTful API using PHP attributes (preferred) or PHPDoc annotations
Latest stable
7.8.0
Last release 4 days ago
18 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 57 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
15 years old
241 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
Improve example of using global parameter references by @DerManoMann in https://github.com/zircote/swagger-php/pull/1450
Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.10...4.7.11
Better documentation for annotations/attributes by @MalekMneri in https://github.com/zircote/swagger-php/pull/1441
RequestBody attribute IS_REPEATABLE by @DerManoMann in https://github.com/zircote/swagger-php/pull/1445Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.9...4.7.10
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Removed error catching on invalid attributes by @stollr in https://github.com/zircote/swagger-php/pull/1432
description property to PathItem by @DerManoMann in https://github.com/zircote/swagger-php/pull/1438Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.8...4.7.9
Add MediaType as possible type to RequestBody by @Malezha in https://github.com/zircote/swagger-php/pull/1426
Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.4...4.7.8
Fix @var docblock parsing by @DerManoMann in https://github.com/zircote/swagger-php/pull/1429
@var docblock parsing by @DerManoMann in https://github.com/zircote/swagger-php/pull/1429Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.3...4.7.4
Improve api doc by @gnovaro in https://github.com/zircote/swagger-php/pull/1399
AbstractAnnotation::isRoot() as strict check in Analysis::getAnnotationsOfType() by @DerManoMann in https://github.com/zircote/swagger-php/pull/1425Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.2...4.7.3
Some minor refactoring by @DerManoMann in https://github.com/zircote/swagger-php/pull/1420
Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.1...4.7.2
Allow FQCN in $ref by @DerManoMann in https://github.com/zircote/swagger-php/pull/1418
$ref by @DerManoMann in https://github.com/zircote/swagger-php/pull/1418Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.0...4.7.1
Refactor use of deprecated phpunit assertObjectHasAttribute() by @DerManoMann in https://github.com/zircote/swagger-php/pull/1414
assertObjectHasAttribute() by @DerManoMann in https://github.com/zircote/swagger-php/pull/1414isRoot() call on annotation safe by @DerManoMann in https://github.com/zircote/swagger-php/pull/1417Full Changelog: https://github.com/zircote/swagger-php/compare/4.6.2...4.7.0
Fix spelling of oneOf by @DerManoMann in https://github.com/zircote/swagger-php/pull/1404
oneOf by @DerManoMann in https://github.com/zircote/swagger-php/pull/1404Full Changelog: https://github.com/zircote/swagger-php/compare/4.6.1...4.6.2
Add (optional) ProcessorInterface and update method signatures by @DerManoMann in https://github.com/zircote/swagger-php/pull/1390
Full Changelog: https://github.com/zircote/swagger-php/compare/4.6.0...4.6.1
Enum cleanup by @DerManoMann in https://github.com/zircote/swagger-php/pull/1381
The enum cleanup simplifies the rules around backed enums and fixes some edge cases where the values did not match the set type (typically when using the backed values but using string as type).
With this change backed enum schemas will always use the enum names, *unless the schema type is set and matches the backing type. This is even true for string type backed enums.
Full Changelog: https://github.com/zircote/swagger-php/compare/4.5.6...4.6.0
Add openapi-extras and fix some typos by @DerManoMann in https://github.com/zircote/swagger-php/pull/1385
Examples attribute to be repeatable by @jtreminio in https://github.com/zircote/swagger-php/pull/1389Full Changelog: https://github.com/zircote/swagger-php/compare/4.5.5...4.5.6
Update cookbook.md by @atilacamurca in https://github.com/zircote/swagger-php/pull/1382
Full Changelog: https://github.com/zircote/swagger-php/compare/4.5.4...4.5.5
Allow and support doctrine/annotations ^2.0 by @DerManoMann in https://github.com/zircote/swagger-php/pull/1375
schema property only on actual Schema instances by @DerManoMann in https://github.com/zircote/swagger-php/pull/1379Full Changelog: https://github.com/zircote/swagger-php/compare/4.5.3...4.5.4
Allow to specify a before processor classname when adding a new pro… by @DerManoMann in https://github.com/zircote/swagger-php/pull/1367
before processor classname when adding a new pro… by @DerManoMann in https://github.com/zircote/swagger-php/pull/1367Full Changelog: https://github.com/zircote/swagger-php/compare/4.5.2...4.5.3
Adding copyright notice by @DerManoMann in https://github.com/zircote/swagger-php/pull/1347
Full Changelog: https://github.com/zircote/swagger-php/compare/4.5.1...4.5.2
Disable deprecation warning until issues sorted downstream by @DerManoMann in https://github.com/zircote/swagger-php/pull/1345
content to Parameter attribute by @DerManoMann in https://github.com/zircote/swagger-php/pull/1344Full Changelog: https://github.com/zircote/swagger-php/compare/4.5.0...4.5.1
Raise deprecation warning for Context::detect by @DerManoMann in https://github.com/zircote/swagger-php/pull/1334
_aux property with context generated by @DerManoMann in https://github.com/zircote/swagger-php/pull/1333Context::detect by @DerManoMann in https://github.com/zircote/swagger-php/pull/1334Full Changelog: https://github.com/zircote/swagger-php/compare/4.4.10...4.5.0
Refresh reference docs and disable xdebug on CL by @DerManoMann in https://github.com/zircote/swagger-php/pull/1312
Schema attribute to be repeatable by @DerManoMann in https://github.com/zircote/swagger-php/pull/1330Full Changelog: https://github.com/zircote/swagger-php/compare/4.4.9...4.4.10
Address psalm warnings by @DerManoMann in https://github.com/zircote/swagger-php/pull/1297
Full Changelog: https://github.com/zircote/swagger-php/compare/4.4.8...4.4.9
Add single_line_comment_spacing rule by @DerManoMann in https://github.com/zircote/swagger-php/pull/1282
single_line_comment_spacing rule by @DerManoMann in https://github.com/zircote/swagger-php/pull/1282AttributeAnnotationFactoryTest and fixtures by @DerManoMann in https://github.com/zircote/swagger-php/pull/1283uses details on context by @DerManoMann in https://github.com/zircote/swagger-php/pull/1294isRoot priority map by @DerManoMann in https://github.com/zircote/swagger-php/pull/1296Full Changelog: https://github.com/zircote/swagger-php/compare/4.4.7...4.4.8
Do not return annotations merged into an explicit parent in AttributeAnnotationFactory by @GuilhemN in https://github.com/zircote/swagger-php/pull/127
Full Changelog: https://github.com/zircote/swagger-php/compare/4.4.6...4.4.7
[PHP 8.2] Fix ${var} string interpolation deprecation by @Ayesh in https://github.com/zircote/swagger-php/pull/1266
${var} string interpolation deprecation by @Ayesh in https://github.com/zircote/swagger-php/pull/1266Full Changelog: https://github.com/zircote/swagger-php/compare/4.4.5...4.4.6
X typehint by @DerManoMann in https://github.com/zircote/swagger-php/pull/1255
Full Changelog: https://github.com/zircote/swagger-php/compare/4.4.4...4.4.5
Detect nullable on constructor property promotion by @DerManoMann in https://github.com/zircote/swagger-php/pull/1250
Full Changelog: https://github.com/zircote/swagger-php/compare/4.4.3...4.4.4
Allow the property attribute to be repeated by @DerManoMann in https://github.com/zircote/swagger-php/pull/1240
Full Changelog: https://github.com/zircote/swagger-php/compare/4.4.2...4.4.3
Refactor strategy determining the root annotation in a context by @DerManoMann in https://github.com/zircote/swagger-php/pull/1227
Full Changelog: https://github.com/zircote/swagger-php/compare/4.4.1...4.4.2
Re-add object as typehint for $ref by @DerManoMann in https://github.com/zircote/swagger-php/pull/1229
$ref by @DerManoMann in https://github.com/zircote/swagger-php/pull/1229Full Changelog: https://github.com/zircote/swagger-php/compare/4.4.0...4.4.1
Refactor example code to avoid text on stdout by @DerManoMann in https://github.com/zircote/swagger-php/pull/1208
null by @DerManoMann in https://github.com/zircote/swagger-php/pull/1209required for Parameter by @DerManoMann in https://github.com/zircote/swagger-php/pull/1225Full Changelog: https://github.com/zircote/swagger-php/compare/4.3.0...4.4.0
Skip inherited interfaces when expanding by @DerManoMann in https://github.com/zircote/swagger-php/pull/1202
\Attribute::TARGET_PARAMETER by @DerManoMann in https://github.com/zircote/swagger-php/pull/1206Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.15...4.3.0
Rename license file to be in line with what GH expects by @DerManoMann in https://github.com/zircote/swagger-php/pull/1188
Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.14...4.2.15
Added deprecated to OperationTrait by @tm1000 in https://github.com/zircote/swagger-php/pull/1175
Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.13...4.2.14
Add missing request parameter for RequestBody.php by @lempzz in https://github.com/zircote/swagger-php/pull/1173
request parameter for RequestBody.php by @lempzz in https://github.com/zircote/swagger-php/pull/1173ref parameter for RequestBody.php by @lempzz in https://github.com/zircote/swagger-php/pull/1174Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.12...4.2.13
Add some tests by @DerManoMann in https://github.com/zircote/swagger-php/pull/1155
Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.11...4.2.12
Ignore operationId null by @DerManoMann in https://github.com/zircote/swagger-php/pull/1154
null by @DerManoMann in https://github.com/zircote/swagger-php/pull/1154Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.10...4.2.11
Fix a doc link to Annotation support by @kkreft in https://github.com/zircote/swagger-php/pull/1133
Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.9...4.2.10
Express nullable in 3.1.0 by @DerManoMann in https://github.com/zircote/swagger-php/pull/1125
Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.8...4.2.9
Add multi value query parameter recipe by @DerManoMann in https://github.com/zircote/swagger-php/pull/1115
Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.7...4.2.8
Enables more attribute targets for OpenApi\Attributes\Examples. by @abbluiz-userh in https://github.com/zircote/swagger-php/pull/1110
@DoctrineAnnotation rule and apply to Examples by @DerManoMann in https://github.com/zircote/swagger-php/pull/1111Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.6...4.2.7
Fix Discriminator Attribute mapping property type hint by @b-vadym in https://github.com/zircote/swagger-php/pull/1089
Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.5...4.2.6
fix: remove ` by @Gemorroj in https://github.com/zircote/swagger-php/pull/1081
Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.4...4.2.5
Update docblock by @DerManoMann in https://github.com/zircote/swagger-php/pull/1075
Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.3...4.2.4
Improve attribute type system by @DerManoMann in https://github.com/zircote/swagger-php/pull/1065
Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.2...4.2.3
Improve PHP 8.1 enum handling by @DerManoMann in https://github.com/zircote/swagger-php/pull/1060
Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.1...4.2.2
Response: Pass ref to parent constructor. by @SlvrEagle23 in https://github.com/zircote/swagger-php/pull/1057
Response: Pass ref to parent constructor. by @SlvrEagle23 in https://github.com/zircote/swagger-php/pull/1057Full Changelog: https://github.com/zircote/swagger-php/compare/4.2.0...4.2.1
Main change is reverting back to 3.0.0 as default OpenAPI version. 3.1.0 can specs can be generated using a new CLI option or programmatically on the
Main change is reverting back to 3.0.0 as default OpenAPI version. 3.1.0 can specs can be generated using a new CLI option or
programmatically on the Generator using setVersion().
Full Changelog: https://github.com/zircote/swagger-php/compare/4.1.1...4.2.0
Extend PathParameter tests with schema and description. by @DerManoMann in https://github.com/zircote/swagger-php/pull/1045
Response by @DerManoMann in https://github.com/zircote/swagger-php/pull/1048Full Changelog: https://github.com/zircote/swagger-php/compare/4.1.0...4.1.1
Main feature is a switch to OpenAPI 3.1.0 wih support for summary/description next to $ref.
Main feature is a switch to OpenAPI 3.1.0 wih support for summary/description next to $ref.
Another change is to move attributes into their own namespace OpenAPI\Attributes which solves warnings from
static analysers and does make the code more maintainable.
Finally. named arguments for attributes extending from Schema have been clean up and updated.
Licence by @DerManoMann in https://github.com/zircote/swagger-php/pull/1038Full Changelog: https://github.com/zircote/swagger-php/compare/4.0.5...4.1.0
Add missing parameter attribute args by @DerManoMann in https://github.com/zircote/swagger-php/pull/1025
Full Changelog: https://github.com/zircote/swagger-php/compare/4.0.4...4.0.5
Make TokenScanner handle multiple namespaces in single file by @DerManoMann in https://github.com/zircote/swagger-php/pull/1020
TokenScanner handle multiple namespaces in single file by @DerManoMann in https://github.com/zircote/swagger-php/pull/1020Full Changelog: https://github.com/zircote/swagger-php/compare/4.0.3...4.0.4
Fix token scanning/parsing for PHP8 named arguments by @DerManoMann in https://github.com/zircote/swagger-php/pull/1019
Full Changelog: https://github.com/zircote/swagger-php/compare/4.0.2...4.0.3
Allow composer/package-versions-deprecated updates by @DerManoMann in https://github.com/zircote/swagger-php/pull/1015
TokenScanner bug around ${ and {$ token handling. Fixes #1016 #1005 by @DerManoMann in https://github.com/zircote/swagger-php/pull/1017Full Changelog: https://github.com/zircote/swagger-php/compare/4.0.1...4.0.2
add psr/log 2.0 and 3.0 by @Gemorroj in https://github.com/zircote/swagger-php/pull/1008
Full Changelog: https://github.com/zircote/swagger-php/compare/4.0.0...4.0.1
Same as RC1. Fixes #1002 #806
Same as RC1. Fixes #1002 #806
Removal of deprecated static properties used to configure the underlying Doctrine annotations parser
PathParameter addedAttachable to allow to attach any data to annotations/attributes without affecting the generated specUpdate for PHP 8.2 by @DerManoMann in https://github.com/zircote/swagger-php/pull/1377
Full Changelog: https://github.com/zircote/swagger-php/compare/3.3.6...3.3.7
fix return type for Symfony debug class by @shyim in https://github.com/zircote/swagger-php/pull/1245
Full Changelog: https://github.com/zircote/swagger-php/compare/3.3.4...3.3.6
Fix deprecated messages by @DerManoMann in https://github.com/zircote/swagger-php/pull/1137
Full Changelog: https://github.com/zircote/swagger-php/compare/3.3.3...3.3.5
Fix deprecated messages by @DerManoMann in https://github.com/zircote/swagger-php/pull/1137
Full Changelog: https://github.com/zircote/swagger-php/compare/3.3.3...3.3.4
One column per quarter.