api.base.ahbmz.com/vendor/zircote/swagger-php/docs/index.md

home	actionText	actionLink	features
true	Get Started →	/Getting-started	{title OpenAPI specification} {details Compatible with the OpenAPI Specification version 3. formerly known as Swagger.}] [{title Use @Annotations} {details Write the documentation inside the php source files which helps to keep the documentation in sync.}] [{title Useful error messages} {details Enhanced errors messages with hints and context.}

Install with composer:

composer require zircote/swagger-php

Create a php file:

<?php
require("vendor/autoload.php");
$openapi = \OpenApi\scan('/path/to/project');
header('Content-Type: application/x-yaml');
echo $openapi->toYaml();

Add annotations to your php files.

/**
 * @OA\Info(title="My First API", version="0.1")
 */

/**
 * @OA\Get(
 *     path="/api/resource.json",
 *     @OA\Response(response="200", description="An example resource")
 * )
 */

And view and interact with your API using Swagger UI

Links

• Getting started guide
• OpenApi Documentation
• OpenApi Specification
• Migration from 2.x to 3.x
• Learn by example lots of example of how to generate
• Related projects
• Swagger-php 2.x documentation The docs for swagger-php v2
• Swagger-php 1.x documentation The docs for swagger-php v1