In total there are a number of different aspects to using swagger-php. Depending on how custom your requirements are this might be limited to just annotating your code and using the command line tool.
However, swagger-php offers more.
-
The new way of adding meta-data to your codebase. Requires PHP 8.1
-
The 'traditional' way of documenting your API.
-
The
GeneratorThe
\OpenAPI\Generatorclass is the main entry point to programmatically generate OpenAPI documents from your code. -
swagger-phpcomes with a list of pre-defined processors that convert the raw data to a complete OpenAPI document. Custom processors can be added or existing removed to tweak swagger-php` to your requirements.