mevdschee / mevdschee/php-crud-api

OpenAPI, required on create schemas and 3.1 output

Open
#1,085 0 comments 0 reactions 1 assignee View on GitHub

@mevdschee is already working on this.

Since Aug 28, 2026.

enhancement
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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.