zircote/swagger-php
swagger-php generates OpenAPI 3.0/3.1/3.2 documentation from your PHP 8.2+ code using attributes (preferred) or optional Doctrine annotations. Use it via CLI or programmatically, with helpful error reporting and a full documentation site.
The specification allows for custom properties
as long as they start with "x-". Therefore, all swagger-php annotations have an x property which accepts an array (map)
and will unfold into "x-" properties.
<<< @/snippets/guide/vendor-extensions/custom_property_at.php
<<< @/snippets/guide/vendor-extensions/custom_property_an.php
Results in:
openapi: 3.0.0
info:
title: Example
version: 1
x-some-name: a-value
x-another: 2
x-complex-type:
supported:
- version: "1.0"
level: baseapi
- version: "2.1"
level: fullapi
How can I help you explore Laravel packages today?