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.
add psr/log 2.0 to 3.x branch by @Gemorroj in https://github.com/zircote/swagger-php/pull/1006
Full Changelog: https://github.com/zircote/swagger-php/compare/3.3.2...3.3.3
handle nullable typed arrays by @dbu in https://github.com/zircote/swagger-php/pull/998
Full Changelog: https://github.com/zircote/swagger-php/compare/3.3.1...3.3.2
Bug fix release with a temporary fix to handle missing context when using swagger-php via the nelmio annotation bundle (symfony)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Bug fix release with a temporary fix to handle missing context when using swagger-php via the nelmio annotation bundle (symfony)
Switch to non-static PSR logger internally
GeneratorAttachable annotation to attach arbitrary data to actual OpenApi annotationsFixes a regressing in MergeIntoOpenApi
Bug fix release
MergeIntoOpenApiImprove uniqueness of generated operationId; aslo hash the value by default to avoid leaking imlementation details
operationId; aslo hash the value by default to avoid leaking imlementation detailsoneOfFix regression around traits without @OA\Schema annotation.
Fix regression around traits without @OA\Schema annotation.
This release marks a few things replaced by the Generator as deprecated:
Generator class to provide a single OO entrypoint into running swagger-php
see: https://zircote.github.io/swagger-php/Generator-migration.htmlThis release marks a few things replaced by the Generator as deprecated:
OpenApi\\UNDEFINED, OpenApi\\Annotations\\UNDEFINED and OpenApi\\Processors\\UNDEFINEDOpenApi\\scan() functionAnalyser::$whitelistAnalyser::$defaultImportsOpenApi\\Logger classFixed a syntax error, and used a minor version bump to indicate feature changes since 3.0.4
Fixed a syntax error, and used a minor version bump to indicate feature changes since 3.0.4
Fixes and improvements, like: - Better trait support - Improved code formatting - And more... Many thanks to @DerManoMann
Fixes and improvements, like:
Many thanks to @DerManoMann
Misc bug fixes and improvements:
Misc bug fixes and improvements:
Misc bugfixes and improvements.
Nothing published for this version
Fixed allOf in InheritProperties
|null, so @var string|null will be detected as type stringSwagger-PHP v3 supports the swagger specification version 3 which was rebranded as the OpenApi Specification.
Swagger-PHP v3 supports the swagger specification version 3 which was rebranded as the OpenApi Specification.
Look at the Visual Guide to What's New in the 3.0 spec for more info.
swagger-php v3.x does not support older versions of the specification. If you need to output swagger v2 documentation, use the latest 2.x release.
This release was made possible by community. Many thanks to @sonrac and all the other contributors for creating PR's and filling issues.
Take a look at the migration guide on our new documentation website
These docs are generated from the markdown files in the docs/ folder, which makes it easier to contribute.
Fix deprecated error in PHP 8.1/8.2 by @koriym in https://github.com/zircote/swagger-php/pull/1474
Full Changelog: https://github.com/zircote/swagger-php/compare/2.1.2...2.1.13
type deprecation fix for preg_match and preg_split for php 8.1 by @potasiyam in https://github.com/zircote/swagger-php/pull/1265
Full Changelog: https://github.com/zircote/swagger-php/compare/2.1.1...2.1.2
fix php 8.1 deprecations in 2.x by @Tobion in https://github.com/zircote/swagger-php/pull/984
Full Changelog: https://github.com/zircote/swagger-php/compare/2.1.0...2.1.1
Nothing published for this version
- Fixed opcache compatiblity bug
- Added support for PHP 7.4 #741
Backport of #643 (Add var type detection when null is also set)
Dynamic reference example and improvements #463
~1 for / and ~0 for ~Added field allowEmptyValue #451
Implemented Swagger->ref(). $swagger->ref('#/info/contact') === $swagger->info->contact
Fix errors when parsing php7 anonymous class #380, #390
Added support for PHP 7.1 and dropped support for PHP 5.5 and below
Dynamic Definitions / partial support #301
Beter validation of type="file" #305
Deserializer added to convert json string into a Swagger Annotations object (@csimplestring)
Release 2.0.6
Removed JSON-Schema properties that are not supported in swagger. #273
Removed format restrictions from the remaining annotations #253
Removed format restrictions #253
Added support for @SWG\Head & @SWG\Options for documenting the HEAD and OPTIONS responses
@SWG\Head & @SWG\Options for documenting the HEAD and OPTIONS responses@SWG\Items, allow @SWG\Property and other @SWG\Schema options.Minimal support for traits (no inheritance)
Generates swagger.json with Swagger Specification v2
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
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
One column per quarter.