diegoborgs/natural-swagger-php

The Swagger UI Render for you PHP Application

1.0.4 2022-01-07 18:22 UTC

Requires

• psr/container: ^2.0
• twig/twig: ^3.0
• zircote/swagger-php: ^3.3

Requires (Dev)

• mockery/mockery: ^1.4
• phpunit/phpunit: ^9.5

MIT

• Diego Borges

README

The NaturalSwagger allows you to generate a decent documentation for your APIs. This library is based on zircote/swagger-php and swagger-ui.

This library provide for your system a swagger UI based

How to use

Install with composer:

composer require diegoborgs/natural-swagger-php

Add to your code:

use Diegoborgs\NaturalSwaggerPhp\OpenApiRenderFactory;
use Diegoborgs\NaturalSwaggerPhp\Renders\RenderOpenApi;

$render = OpenApiRenderFactory::get();
$render->render(RenderOpenApi::HTML,  ['base_path' => '/path/to/annotations']);

Contributing

Fork the project and send your PR.

Running the Tests

Install the Composer dependencies:

git clone https://github.com/eudiegoborgs/natural-swagger-php.git
cd natural-swagger-php
docker-compose run --rm composer update 
// or
composer update

Then run the test suite:

docker-compose run --rm composer test 
// or
composer test

License

This bundle is released under the MIT license.