cebe / cebe/php-openapi

Support OpenAPI 3.1

Đang mở
#101 2 bình luận 15 reaction 0 người được giao Xem trên GitHub
openapi 3.1
Ngôn ngữ chính
PHP
Star
500
Fork
99
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Mô tả

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

Hướng dẫn đóng góp

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

Hướng nghiên cứu

Bắt đầu bằng cách xem lại các ghi chú di chuyển từ OpenAPI 3.0 sang 3.1 được liên kết trong issue và so sánh chúng với cách thư viện này hiện xử lý OpenAPI. Công việc được xem là hoàn tất khi thư viện hỗ trợ các thay đổi 3.1 được liệt kê, bao gồm các kiểu nullable, các giới hạn loại trừ trực tiếp, các ví dụ, payload tải tệp lên và các dialect JSON Schema tường minh.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
openapi, php
Lĩnh vực
api
Loại issue
Tính năng
Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức độ hoạt động
Đình trệ
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
35/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.