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

Research direction

Start by reviewing the OpenAPI 3.0-to-3.1 migration notes linked in the issue and comparing them with this library’s current OpenAPI handling. Done means the library supports the listed 3.1 changes, including nullable types, direct exclusive bounds, examples, file upload payloads, and explicit JSON Schema dialects.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi, php
Domain
api
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.