NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #350 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 2 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.
chore(v5) Add missing versions '3.1.2' and '3.2.0' by @DerManoMann in https://github.com/zircote/swagger-php/pull/1872
'3.1.2' and '3.2.0' by @DerManoMann in https://github.com/zircote/swagger-php/pull/1872patternProperties to attributes by @DerManoMann in https://github.com/zircote/swagger-php/pull/1877summary/description default value to support null as user provided value (#1886) by @DerManoMann in https://github.com/zircote/swagger-php/pull/1889Full Changelog: https://github.com/zircote/swagger-php/compare/5.7.6...5.7.7
[v5] Methods SplObjectStorage::attach(), detach & contains() are deprecated since PHP 8.5 by @DerManoMann in https://github.com/zircote/swagger-php/pu…
Full Changelog: https://github.com/zircote/swagger-php/compare/5.7.5...5.7.6
Your coding agent can read these notes before it upgrades. Set up the MCP server →
[v5] Allow to disable default tag descriptions by @DerManoMann in https://github.com/zircote/swagger-php/pull/1859
AugmentItems processor by @DerManoMann in https://github.com/zircote/swagger-php/pull/1863Full Changelog: https://github.com/zircote/swagger-php/compare/5.7.4...5.7.5
Backport latest changes of LegacyTypeResolver from v6 by @DerManoMann in https://github.com/zircote/swagger-php/pull/1851
Full Changelog: https://github.com/zircote/swagger-php/compare/5.7.3...5.7.4
Consider oneOf, allOf and anyOf when deciding on whether to modify the schema type by @DerManoMann in https://github.com/zircote/swagger-php/pull/1847
oneOf, allOf and anyOf when deciding on whether to modify the schema type by @DerManoMann in https://github.com/zircote/swagger-php/pull/1847Full Changelog: https://github.com/zircote/swagger-php/compare/5.7.2...5.7.3
Handle Mixed union type incl. array in LegacyTypeResolver by @DerManoMann in https://github.com/zircote/swagger-php/pull/1844
array in LegacyTypeResolver by @DerManoMann in https://github.com/zircote/swagger-php/pull/1844false by @DerManoMann in https://github.com/zircote/swagger-php/pull/1849Full Changelog: https://github.com/zircote/swagger-php/compare/5.7.1...5.7.2
Merge multiple Components into a single one by @DerManoMann in https://github.com/zircote/swagger-php/pull/1836
Components into a single one by @DerManoMann in https://github.com/zircote/swagger-php/pull/1836LegacyTypeResolver by @DerManoMann in https://github.com/zircote/swagger-php/pull/1843MediaType::encoding values by @DerManoMann in https://github.com/zircote/swagger-php/pull/1845Full Changelog: https://github.com/zircote/swagger-php/compare/5.7.0...5.7.1
Add Encoding annotation to manage MediaType encodings by @DerManoMann in https://github.com/zircote/swagger-php/pull/1835
Encoding annotation to manage MediaType encodings by @DerManoMann in https://github.com/zircote/swagger-php/pull/1835Full Changelog: https://github.com/zircote/swagger-php/compare/5.6.1...5.7.0
Add contentEncoding and contentMediaType to Schema by @DerManoMann in https://github.com/zircote/swagger-php/pull/1831
contentEncoding and contentMediaType to Schema by @DerManoMann in https://github.com/zircote/swagger-php/pull/1831method_exists on reflector by @DjordyKoert in https://github.com/zircote/swagger-php/pull/1833Full Changelog: https://github.com/zircote/swagger-php/compare/5.6.0...5.6.1
Mark Analysis::getSchemaForSource() as deprecated by @DerManoMann in https://github.com/zircote/swagger-php/pull/1830
Type resolver refactor by @DerManoMann in https://github.com/zircote/swagger-php/pull/1829 This 2nd round moved all data manipulation from the analyser and annotation factories into the a appropriate processors and improved type resolvers. Drops support for:
Context::typeContext:nullableMark Analysis::getSchemaForSource() as deprecated by @DerManoMann in https://github.com/zircote/swagger-php/pull/1830
Full Changelog: https://github.com/zircote/swagger-php/compare/5.5.2...5.6.0
Deprecate current type resolver interface by @DerManoMann in https://github.com/zircote/swagger-php/pull/1828
Full Changelog: https://github.com/zircote/swagger-php/compare/5.5.1...5.5.2
Improve docs and fix broken link by @DerManoMann in https://github.com/zircote/swagger-php/pull/1825
Context has a reflector and is not nested by @DerManoMann in https://github.com/zircote/swagger-php/pull/1824Full Changelog: https://github.com/zircote/swagger-php/compare/5.5.0...5.5.1
Add description to enum property which is used in 3.1.x only by @DerManoMann in https://github.com/zircote/swagger-php/pull/1818
radebatz/type-info-extras by @DerManoMann in https://github.com/zircote/swagger-php/pull/1821Full Changelog: https://github.com/zircote/swagger-php/compare/5.4.2...5.5.0
Allow array as $type type in mapNativeType() by @DerManoMann in https://github.com/zircote/swagger-php/pull/1812
array as $type type in mapNativeType() by @DerManoMann in https://github.com/zircote/swagger-php/pull/1812Full Changelog: https://github.com/zircote/swagger-php/compare/5.4.1...5.4.2
Mark Analysis::process() as deprecated by @DerManoMann in https://github.com/zircote/swagger-php/pull/1815
GeneratorAwareInterface by @DerManoMann in https://github.com/zircote/swagger-php/pull/1813GeneratorAwareInterface also when setting new Pipeline by @DerManoMann in https://github.com/zircote/swagger-php/pull/1814Analysis::process() as deprecated by @DerManoMann in https://github.com/zircote/swagger-php/pull/1815Full Changelog: https://github.com/zircote/swagger-php/compare/5.4.0...5.4.1
Add a single-file-multi-namespace fixture + test by @DerManoMann in https://github.com/zircote/swagger-php/pull/1796
Full Changelog: https://github.com/zircote/swagger-php/compare/5.3.2...5.4.0
Bump actions/checkout from 4 to 5 by @dependabot[bot] in https://github.com/zircote/swagger-php/pull/1791
3.0.x and 3.1.x version numbers by @DerManoMann in https://github.com/zircote/swagger-php/pull/1790Context::__serialize by @DerManoMann in https://github.com/zircote/swagger-php/pull/1794Full Changelog: https://github.com/zircote/swagger-php/compare/5.3.1...5.3.2
Ensure Context can be serialized by @DerManoMann in https://github.com/zircote/swagger-php/pull/1789
Context can be serialized by @DerManoMann in https://github.com/zircote/swagger-php/pull/1789Full Changelog: https://github.com/zircote/swagger-php/compare/5.3.0...5.3.1
Convert annotated type array into single type + nullable for 3.0 by @DerManoMann in https://github.com/zircote/swagger-php/pull/1786
type array into single type + nullable for 3.0 by @DerManoMann in https://github.com/zircote/swagger-php/pull/1786Full Changelog: https://github.com/zircote/swagger-php/compare/5.2.0...5.3.0
Support use x-* in ref by @krissss in https://github.com/zircote/swagger-php/pull/1776
Full Changelog: https://github.com/zircote/swagger-php/compare/5.1.4...5.2.0
Fix parameter type by @krissss in https://github.com/zircote/swagger-php/pull/1775
Full Changelog: https://github.com/zircote/swagger-php/compare/5.1.3...5.1.4
Add deprecations for v6 by @DerManoMann in https://github.com/zircote/swagger-php/pull/1772
Full Changelog: https://github.com/zircote/swagger-php/compare/5.1.2...5.1.3
Normalize generated snippet test namespace by @DerManoMann in https://github.com/zircote/swagger-php/pull/1768
OperationId processor instead patching namespace by @DerManoMann in https://github.com/zircote/swagger-php/pull/1769Full Changelog: https://github.com/zircote/swagger-php/compare/5.1.1...5.1.2
Removes Changelog.md by @mvhirsch in https://github.com/zircote/swagger-php/pull/1758
Full Changelog: https://github.com/zircote/swagger-php/compare/5.1.0...5.1.1
Fix duplicate attachables by @smallsung in https://github.com/zircote/swagger-php/pull/1744
composer.json by @OskarStark in https://github.com/zircote/swagger-php/pull/1752GeneratorAware trait and interface by @DerManoMann in https://github.com/zircote/swagger-php/pull/1755OpenApi attributes by @DerManoMann in https://github.com/zircote/swagger-php/pull/1756required: true for OAT\PathParameter by @DerManoMann in https://github.com/zircote/swagger-php/pull/1753Full Changelog: https://github.com/zircote/swagger-php/compare/5.0.7...5.1.0
Remove redundant PHP version check (7.4) by @DerManoMann in https://github.com/zircote/swagger-php/pull/1740
x-enumNames for BackedEnums by @BusterNeece in https://github.com/zircote/swagger-php/pull/1724procgen changes to support code blocks by @DerManoMann in https://github.com/zircote/swagger-php/pull/1742Full Changelog: https://github.com/zircote/swagger-php/compare/5.0.6...5.0.7
feat: MetaStorm Integration by @xepozz in https://github.com/zircote/swagger-php/pull/1713
MutliTypeProperty and VendorExtensions scratch tests by @DerManoMann in https://github.com/zircote/swagger-php/pull/1727phpdoc_separation by @DerManoMann in https://github.com/zircote/swagger-php/pull/1734polymorphism example and add to examples in docs by @DerManoMann in https://github.com/zircote/swagger-php/pull/1735PathFilter by @DerManoMann in https://github.com/zircote/swagger-php/pull/1729Discriminator::mapping by @DerManoMann in https://github.com/zircote/swagger-php/pull/1736Full Changelog: https://github.com/zircote/swagger-php/compare/5.0.5...5.0.6
Clarify webhooks readme wording by @DerManoMann in https://github.com/zircote/swagger-php/pull/1711
Full Changelog: https://github.com/zircote/swagger-php/compare/5.0.4...5.0.5
Remove use of deprecated E_STRICT by @DerManoMann in https://github.com/zircote/swagger-php/pull/1704
E_STRICT by @DerManoMann in https://github.com/zircote/swagger-php/pull/1704type might be an array when checking Item parent type by @DerManoMann in https://github.com/zircote/swagger-php/pull/1708Full Changelog: https://github.com/zircote/swagger-php/compare/5.0.3...5.0.4
Remove the deprecated ProcessorInterface by @DerManoMann in https://github.com/zircote/swagger-php/pull/1696
ProcessorInterface by @DerManoMann in https://github.com/zircote/swagger-php/pull/1696Full Changelog: https://github.com/zircote/swagger-php/compare/5.0.2...5.0.3
Initialize Generator::$context by @brpauwels in https://github.com/zircote/swagger-php/pull/1692
Full Changelog: https://github.com/zircote/swagger-php/compare/5.0.1...5.0.2
docs: Lookup processor defaults from constructor instead of class property by @DerManoMann in https://github.com/zircote/swagger-php/pull/1688
Full Changelog: https://github.com/zircote/swagger-php/compare/5.0.0...5.0.1
Merge Sample fixtures into Scratch tests by @DerManoMann in https://github.com/zircote/swagger-php/pull/1677
-b option for single files by @DerManoMann in https://github.com/zircote/swagger-php/pull/1684Context::getDebugLocation() by @DerManoMann in https://github.com/zircote/swagger-php/pull/1686Full Changelog: https://github.com/zircote/swagger-php/compare/4.11.1...5.0.0
Allow inserting pipes using a class name as matcher by @DerManoMann in https://github.com/zircote/swagger-php/pull/1664
Full Changelog: https://github.com/zircote/swagger-php/compare/4.11.0...4.11.1
Update generator.md by @Kiina in https://github.com/zircote/swagger-php/pull/1662
Attachable annotations by @DerManoMann in https://github.com/zircote/swagger-php/pull/1663Full Changelog: https://github.com/zircote/swagger-php/compare/4.10.7...4.11.0
Prefer attributes, deprecate annotations by @fulldecent in https://github.com/zircote/swagger-php/pull/1651
Context::getVersion() as safe way to access the OpenApi version by @DerManoMann in https://github.com/zircote/swagger-php/pull/1644openapi CLI tools as ./vendor/bin/openapi by @DerManoMann in https://github.com/zircote/swagger-php/pull/1656openapi CLI tools as ./vendor/bin/openapi Part II by @DerManoMann in https://github.com/zircote/swagger-php/pull/1658-b to basic CLI example by @DerManoMann in https://github.com/zircote/swagger-php/pull/1659processor option in Generator::scan() by @DerManoMann in https://github.com/zircote/swagger-php/pull/1660Full Changelog: https://github.com/zircote/swagger-php/compare/4.10.6...4.10.7
Use array_search strict comparison by @DerManoMann in https://github.com/zircote/swagger-php/pull/1632
Full Changelog: https://github.com/zircote/swagger-php/compare/4.10.5...4.10.6
Remove annotation based schema-query-parameter processor example in favour of the attribute version by @DerManoMann in https://github.com/zircote/swag
schema-query-parameter processor example in favour of the attribute version by @DerManoMann in https://github.com/zircote/swagger-php/pull/1628AugmentTags after CleanUnusedComponents by @DerManoMann in https://github.com/zircote/swagger-php/pull/1630Full Changelog: https://github.com/zircote/swagger-php/compare/4.10.4...4.10.5
Remove unused tags by @DerManoMann in https://github.com/zircote/swagger-php/pull/1625
Full Changelog: https://github.com/zircote/swagger-php/compare/4.10.3...4.10.4
Strip duplicate tags in AugmentTags by @DerManoMann in https://github.com/zircote/swagger-php/pull/1622
AugmentTags by @DerManoMann in https://github.com/zircote/swagger-php/pull/1622Full Changelog: https://github.com/zircote/swagger-php/compare/4.10.2...4.10.3
Add processor config section to reference by @DerManoMann in https://github.com/zircote/swagger-php/pull/1618
Full Changelog: https://github.com/zircote/swagger-php/compare/4.10.1...4.10.2
doctrine/annotations is not required if you have switched to attributes by @bobvandevijver in https://github.com/zircote/swagger-php/pull/1605
Generator by @DerManoMann in https://github.com/zircote/swagger-php/pull/1612AugmentTags processor by @DerManoMann in https://github.com/zircote/swagger-php/pull/1615PathFilter processor to filter paths by @DerManoMann in https://github.com/zircote/swagger-php/pull/1613Full Changelog: https://github.com/zircote/swagger-php/compare/4.10.0...4.10.1
Introduce OpenApiException by @DerManoMann in https://github.com/zircote/swagger-php/pull/1602
OpenApiException by @DerManoMann in https://github.com/zircote/swagger-php/pull/1602Full Changelog: https://github.com/zircote/swagger-php/compare/4.9.3...4.9.4
Mention doctrine annotations must be installed manually by @winternet-studio in https://github.com/zircote/swagger-php/pull/1590
Context::other by @DerManoMann in https://github.com/zircote/swagger-php/pull/1601Full Changelog: https://github.com/zircote/swagger-php/compare/4.9.2...4.9.3
Switch annotation/attribute tab order to make showing attributes the default by @DerManoMann in https://github.com/zircote/swagger-php/pull/1587
Analysis have a root context by @DerManoMann in https://github.com/zircote/swagger-php/pull/1586Full Changelog: https://github.com/zircote/swagger-php/compare/4.9.1...4.9.2
Add example schema-query-parameter-attributes processor by @beeyev in https://github.com/zircote/swagger-php/pull/1569
jsonSerialize return by @AurelienPillevesse in https://github.com/zircote/swagger-php/pull/1575Full Changelog: https://github.com/zircote/swagger-php/compare/4.9.0...4.9.1
Change PHPUint dataProviders methods to be static by @DerManoMann in https://github.com/zircote/swagger-php/pull/1564
Context to 3.0.0 by @DerManoMann in https://github.com/zircote/swagger-php/pull/1563Full Changelog: https://github.com/zircote/swagger-php/compare/4.8.7...4.9.0
CS: enable no_superfluous_phpdoc_tags rule and updated deprecated ones by @DerManoMann in https://github.com/zircote/swagger-php/pull/1558
no_superfluous_phpdoc_tags rule and updated deprecated ones by @DerManoMann in https://github.com/zircote/swagger-php/pull/1558Full Changelog: https://github.com/zircote/swagger-php/compare/4.8.6...4.8.7
Fix resolving general component refs by @DerManoMann in https://github.com/zircote/swagger-php/pull/1557
Full Changelog: https://github.com/zircote/swagger-php/compare/4.8.5...4.8.6
Fix typehint to make null a valid enum value by @DerManoMann in https://github.com/zircote/swagger-php/pull/1548
null a valid enum value by @DerManoMann in https://github.com/zircote/swagger-php/pull/1548Full Changelog: https://github.com/zircote/swagger-php/compare/4.8.4...4.8.5
use @deprecated phpdoc to augment properties by @cdaguerre in https://github.com/zircote/swagger-php/pull/1543
Full Changelog: https://github.com/zircote/swagger-php/compare/4.8.3...4.8.4
Follow CS and phpstan changes by @DerManoMann in https://github.com/zircote/swagger-php/pull/1530
Full Changelog: https://github.com/zircote/swagger-php/compare/4.8.2...4.8.3
Add openapi-serialize project to related projects list by @MattyRad in https://github.com/zircote/swagger-php/pull/1518
Full Changelog: https://github.com/zircote/swagger-php/compare/4.8.1...4.8.2
Webhooks 2 by @DerManoMann in https://github.com/zircote/swagger-php/pull/1511
Full Changelog: https://github.com/zircote/swagger-php/compare/4.8.0...4.8.1
Make doctrine/annotations optional by @DerManoMann in https://github.com/zircote/swagger-php/pull/1508
Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.16...4.8.0
Preserve properties when $ref is nullable by @DerManoMann in https://github.com/zircote/swagger-php/pull/1487
$ref is nullable by @DerManoMann in https://github.com/zircote/swagger-php/pull/1487type: 'object' when moving properties into allOf by @DerManoMann in https://github.com/zircote/swagger-php/pull/1489Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.15...4.7.16
Add missing fixture by @DerManoMann in https://github.com/zircote/swagger-php/pull/1480
$ref in allOf by @DerManoMann in https://github.com/zircote/swagger-php/pull/1481PathItem the same attribute targets as operations by @DerManoMann in https://github.com/zircote/swagger-php/pull/1485enum_exists by @DerManoMann in https://github.com/zircote/swagger-php/pull/1486Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.14...4.7.15
Ignore unexpected properties by @DerManoMann in https://github.com/zircote/swagger-php/pull/1476
Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.13...4.7.14
Fix skip closing curly brace by @Fantom409 in https://github.com/zircote/swagger-php/pull/1468
Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.12...4.7.13
Custom property attr by @DerManoMann in https://github.com/zircote/swagger-php/pull/1466
Full Changelog: https://github.com/zircote/swagger-php/compare/4.7.11...4.7.12
One column per quarter.