cebe / cebe/php-openapi

Support OpenAPI 3.1

オープン
#101 コメント 2 件 リアクション 15 件 担当者 0 名 GitHub で見る
openapi 3.1
主要言語
PHP
スター
500
フォーク
99
PR マージ指標
30日以内にマージされた PR はありません

説明

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

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

評価

技術スタック
openapi, php
領域
api
issue の種類
機能追加
難易度
5/5
見積もり時間
1週間以上
活発さ
停滞
明瞭さ
おおむね明確
初心者へのやさしさ
35/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。