paunin/laswagger

This package allows you to: generate RESTful API document using Swagger PHP

paunin/laswagger

This package is a wrapper for Swagger-php and makes it easy to integrate with Lumen/Larvarel., _(*1)

Usage

Installation

Via Composer, _(*2)

Add information about new package in your composer.json, _(*3)

    "require": {
    ...
        "paunin/laswagger": ">=1.0.0"
    ...
    }

After the composer install finishes, register the service provider:, _(*4)

• Lumen Application:

$app->register(Laswagger\Providers\LumeSwaggerServiceProvider::class);

• Laravel Application: not supports yet.

Now you can wo with laswagger: * Run php artisan swagger:generate file_name [base_host]: to generate swagger api docs., _(*5)

• Go to /swagger/api-docs (default routing config) to see swagger api docs in JSON format

Default configuration

<?php
return [
    'routes' => [
        'prefix' => 'swagger',
        'cors'   => false
    ],
    'api' => [
        'directories' => [base_path('app')],
        'excludes' => [],
        'host' => null
    ]
];

Customize configuration

In order to change default config you can copy the configuration template in config/laswagger.php to your application's config directory and modify according to your needs. For more information see the Configuration Files section in the Lumen documentation., _(*6)

Tests

./vendor/phpunit/phpunit/phpunit

See test result at ./build, _(*7)