cebe / cebe/php-openapi

Support OpenAPI 3.1

Open
#101 2 comments 15 reactions 0 assignees View on GitHub
openapi 3.1
Dominant language
PHP
Stars
500
Forks
99
PR merge metrics
No merged PRs in 30d

Description

OpenAPI 3.1 has just been released... Can we hope for support in this library?

Changes in the spec seems really small, but there are some small BCs that could complicate the stuff further: https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0

Main differences:
* no more `nullable`
```diff
-type: string
-nullable: true
+type:
+ - "string"
+ - "null"
```
* `exclusiveMinimum` and `exclusiveMaximum` are used directly
```diff
-minimum: 7
-exclusiveMinimum: true
+exclusiveMinimum: 7
```
* `examples`, no more `example`
```diff
-example: fedora
+examples:
+ - fedora
```
* Describing File Upload Payloads
* declaring JSON Schema dialect explicitly

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.