Skip to content

switon-php/openapi

Repository files navigation

Switon OpenAPI Package

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.

About

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

Topics

Resources

License

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages