Swagger Php Laravel Package

layout: home hero: name: Swagger-PHP tagline: Generate OpenAPI documentation for your RESTful API. actions: - theme: brand text: User Guide → link: /guide/ features:

• title: OpenAPI conformant details: Generate OpenAPI documents in version 3.0 or 3.1.
• title: Document your API inside PHP source code details: Using swagger-php lets you write the API documentation inside the PHP source files which helps keeping the documentation up-to-date.
• title: Annotation and Attribute support details: Annotations can be either docblocks or PHP 8.1 attributes.

1. Install with composer:

> composer require zircote/swagger-php

2. Update your code

Add swagger-php attributes (or legacy annotations) to your source code.

⚠️ The doctrine/annotations library used to parse annotation is going to be deprecated, so wherever possible attributes should be used.

<<< @/snippets/minimal_api_at.php

<<< @/snippets/minimal_api_an.php

3. Generate OpenAPI documentation

> ./vendor/bin/openapi src -o openapi.yaml

4. Explore and interact with your API

Use an OpenAPI tool like Swagger UI or Scalar to explore and interact with your API.

Links

• User Guide
• Reference
• OpenApi Documentation
• OpenApi Specification
• Learn by example
• Related projects
• swagger-php 2.x documentation
• swagger-php 3.x documentation