Search by

switon / openapi

switon

Split OpenAPI YAML workflow with route sync, merged export, and spec quality lint for Switon Framework

v1.0.0 2026-06-06 13:43 UTC

This package is auto-updated.

Last update: 2026-09-07 05:50:12 UTC


README

OpenAPI CI PHP 8.3+

Switon's OpenAPI pipeline for collecting routes, merging YAML fragments, syncing stubs, and exporting JSON specs.

Highlights

  • Document assembly: route metadata and YAML fragments are merged into one OpenAPI document.
  • Route collection: HTTP controllers can be scanned into OpenAPI entries.
  • Stub sync: discovered routes can generate missing controller and component stubs.
  • CLI workflow: open-api:init, open-api:sync, open-api:export, and open-api:lint cover the spec loop.
  • Spec helpers: response schema guessing and sample-to-schema conversion reduce manual work.

Installation

composer require switon/openapi

Quick Start

bash bin/console open-api:init
bash bin/console open-api:sync
bash bin/console open-api:export
bash bin/console open-api:lint

Docs: https://docs.switon.dev/latest/openapi

License

MIT.