mevdschee / mevdschee/php-crud-api
OpenAPI, required on create schemas and 3.1 output
@mevdschee is already working on this.
Since Aug 28, 2026.
- Dominant language
- PHP
- Stars
- 3.7k
- Forks
- 1k
- Avg merge
- 1h 55m
- Merged PRs (30d)
- 7
Description
Follow up to #1078, which described everything php-crud-api can do except these
two. Both are larger than the phases that are done and neither of them is needed
for the document to be correct.
A faithful required on create schemas
A create schema has no required array. Getting one right means knowing which
columns have a default and which ones are identity columns. ReflectedColumn
carries neither and GenericReflection does not select them, so this means
touching the reflection query of all four drivers and the format of the
reflection cache. Until that is done any required list is a guess, which is
why there is none.
An openApiVersion setting for 3.1 output
The document says 3.0.0 and openApiBase can override that string, but
nothing changes in what is emitted. 3.1 spells a few things differently,
nullable becomes type: [x, "null"] and example becomes examples. Now
that the 3.0 document is complete, a setting can switch the dialect.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.