switon/openapi

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

Requires

• php: >=8.3
• ext-json: *
• switon/command: ^1.0
• switon/core: ^1.0
• switon/http: ^1.0
• switon/router: ^1.0
• switon/yaml: ^1.0

Requires (Dev)

• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.0
• switon/testing: ^1.0

MIT

• switon

• api
• swagger
• openapi
• switon

README

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.