NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1340 most downloaded on Packagist
Read and write OpenAPI yaml/json files and make the content accessable in PHP objects.
Latest stable
1.8.0
Last release 2 years ago
no release in 18 months
Ships unpredictably
gaps range from 2 weeks to 3.0 years
Nearly every release is documented
notes for 19 of 19 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
23 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Added Support for Symfony 7 and PHP 8.2, 8.3 by @tacman
Compatibility:
jsonrainbow/json-schema version 5 and 6 by @tacman (#227)Features and Fixes:
getRawSpecData() by @SOHELAHMED7 (#228)Doucmentation:
Full Changelog: 1.7.0...1.8.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Compatibility:
jsonrainbow/json-schema version 5 and 6 by @tacman (https://github.com/cebe/php-openapi/pull/227)Features and Fixes:
getRawSpecData() by @SOHELAHMED7 (https://github.com/cebe/php-openapi/pull/228)Doucmentation:
Full Changelog: https://github.com/cebe/php-openapi/compare/1.7.0...1.8.0
Support for PHP 8.1, thanks @om4csaba , @shadowhand , @simPod
Improvements:
json_encode() in Writer::writeToJson(), thanks @ValikoDorodnovAdded Docker environment for local development
Bugfixes:
x-*) were not present in the merge result (thanks @marcelthole)Schema::$nullable when no type is specified. nullable will be false by default when a type is specified but null when no type is specified.exclusiveMinimum and exclusiveMaximum only return false when minimum or maximum is specified, defaults to null otherwise.Dependencies:
Other changes:
Fixed typos in README and CLI help (thanks @ssfinney )
Bugfixes:
Documentation:
Bugs #94 Fixed resolving relative paths with multiple ../ (thanks @il-m-yamagishi) Documentation #98 Added PHPStan Template annotations (thanks @marce
../ (thanks @il-m-yamagishi)readFromJsonFile() (thanks @yorickgirard)Overall performance improvements and other optimization for loading references
Improvements:
Bugfixes:
exclusiveMinimum and exclusiveMaximum to boolean (thanks @canvural)Other changes:
3.0 to 3.4 (thanks @marcelthole)#61 Allow Symfony YAML 4.4 to be installed
#68 Fix: Crash with unresolved reference while instantiating Encoding ( @karsa-mistmere )
#56 Added compatibility with symfony/yaml:^5.0 #49 Static Analysis using phpstan ( @lookyman ) #53 Added extra validation messages for parameters ( @l
symfony/yaml:^5.0bin/php-openapi validate (@mfrischbutter)--silent parameter to command-line-tool (@mfrischbutter)#57 Fix transitive reference resolving in the current document context
- #44 Fix recursion issue with reading references which are included multiple times
- #47 Fixed crash when referencing a non-spec object or array
- #41 Fixed an issue with loading references that point to a reference in another file.
Before this change it was necessary to manually call resolveReferences() after loading a file. Now a single call will resolve all references regardles
#35 Symfony YAML is not limited to version 4 anymore, you can now install php-openapi in your symfony 3 project.
#32 References failed to resolve in directory structures when referencing other files from file in subdirectories. These references where resolved in the context of the main OpenAPI file instead of the sub-directories.
Before this change it was necessary to manually call resolveReferences() after loading a file.
Now a single call will resolve all references regardless how many levels deep.
Improved error messages when reading or writing files fails.
Updated docs to consistently use the term API Description instead of API Specification.
$ref in Path Item Objects, following the clarification of semantics.This release brings the following changes:
This release brings the following changes:
@property-read was used even though properties are writeable now.This release brings the following changes:
This release brings the following changes:
array type to the list of constants in Type class (thanks, @scaytrase)OpenAPI v3 got a JSON Schema for validating OpenAPI 3 documents (https://github.com/OAI/OpenAPI-Specification/pull/1270 and https://github.com/OAI/Ope
OpenAPI v3 got a JSON Schema for validating OpenAPI 3 documents (https://github.com/OAI/OpenAPI-Specification/pull/1270 and https://github.com/OAI/OpenAPI-Specification/pull/1897).
This release adds a CLI tool for validating OpenAPI 3 documents against the JSON schema.
Other improvements:
Bug 03c5e82 fix resolving references to a file without jsonPointer
4018163 fix support for references in Responses object
Added PathItem::getOperations() for easier access to operations
PathItem::getOperations() for easier access to operationsFirst release. Ready for testing. This implements full coverage of the OpenAPI 3 Spec. The following functionality is available:
First release. Ready for testing. This implements full coverage of the OpenAPI 3 Spec. The following functionality is available:
Please try it on your OpenAPI spec files and report any issues you see!
One column per quarter.