1
1
# php-openapi
2
2
3
- Read and write [ OpenAPI] ( https://www.openapis.org/ ) 3.0. x YAML and JSON files and make the content accessible in PHP objects.
3
+ Read and write [ OpenAPI] ( https://www.openapis.org/ ) 3.x YAML and JSON files and make the content accessible in PHP objects.
4
4
5
- It also provides a CLI tool for validating and converting OpenAPI 3.0.x Description files.
5
+ It also provides a CLI tool for validating and converting OpenAPI 3.x Description files.
6
+
7
+ Supported OpenAPI versions:
8
+
9
+ - 3.0.x
10
+ - 3.1.x
6
11
7
12
[ ![ Latest Stable Version] ( https://poser.pugx.org/cebe/php-openapi/v/stable )] ( https://packagist.org/packages/cebe/php-openapi )
8
13
[ ![ Total Downloads] ( https://poser.pugx.org/cebe/php-openapi/downloads )] ( https://packagist.org/packages/cebe/php-openapi )
@@ -212,7 +217,7 @@ $openapi->resolveReferences(
212
217
213
218
The library provides simple validation operations, that check basic OpenAPI spec requirements.
214
219
This is the same as "structural errors found while reading the API Description file" from the CLI tool.
215
- This validation does not include checking against the OpenAPI v3.0 JSON schema , this is only implemented in the CLI.
220
+ This validation does not include checking against the OpenAPI v3.0/v3.1 JSON schemas , this is only implemented in the CLI.
216
221
217
222
```
218
223
// return `true` in case no errors have been found, `false` in case of errors.
@@ -225,48 +230,6 @@ $errors = $openapi->getErrors();
225
230
> but the list of errors given may not be complete. Also a passing validation does not necessarily indicate a completely
226
231
> valid spec.
227
232
228
-
229
- ## Completeness
230
-
231
- This library is currently work in progress, the following list tracks completeness:
232
-
233
- - [x] read OpenAPI 3.0 JSON
234
- - [x] read OpenAPI 3.0 YAML
235
- - [ ] OpenAPI 3.0 Schema
236
- - [x] OpenAPI Object
237
- - [x] Info Object
238
- - [x] Contact Object
239
- - [x] License Object
240
- - [x] Server Object
241
- - [x] Server Variable Object
242
- - [x] Components Object
243
- - [x] Paths Object
244
- - [x] Path Item Object
245
- - [x] Operation Object
246
- - [x] External Documentation Object
247
- - [x] Parameter Object
248
- - [x] Request Body Object
249
- - [x] Media Type Object
250
- - [x] Encoding Object
251
- - [x] Responses Object
252
- - [x] Response Object
253
- - [x] Callback Object
254
- - [x] Example Object
255
- - [x] Link Object
256
- - [ ] [ Runtime Expressions] ( https://github.com/OAI/OpenAPI-Specification/blob/3.0.2/versions/3.0.2.md#runtime-expressions )
257
- - [x] Header Object
258
- - [x] Tag Object
259
- - [x] Reference Object
260
- - [x] Schema Object
261
- - [x] load/read
262
- - [ ] validation
263
- - [x] Discriminator Object
264
- - [x] XML Object
265
- - [x] Security Scheme Object
266
- - [x] OAuth Flows Object
267
- - [x] OAuth Flow Object
268
- - [x] Security Requirement Object
269
-
270
233
# Support
271
234
272
235
** Need help with your API project?**
0 commit comments