rabblerouser/api-autodoc

An automatic API documentation creation utility.

laravel-api-autodoc

An automatic api documentation generator for Laravel applications., _(*1)

Quick Start

Installation

Install Through Composer

You can either add the package directly by firing this command, _(*2)

$ composer require rabblerouser/api-autodoc:*

-- or --, _(*3)

Add in the require key of composer.json file manually, _(*4)

"rabblerouser/api-autodoc": "*"

And Run the Composer update command, _(*5)

$ composer update

Add Service Providers (Lumen)

Add the following service providers to your bootstrap/app.php file., _(*6)

$app->register(RabbleRouser\ApiAutoDoc\Providers\DocumentationServiceProvider::class);
$app->register('Irazasyed\Larasupport\Providers\ArtisanServiceProvider');

Add Service Providers (Laravel)

Add the following service providers to your config/app.php file., _(*7)

'providers' => [
    // Other Service Providers
        RabbleRouser\ApiAutoDoc\Providers\DocumentationServiceProvider::class,
        'Irazasyed\Larasupport\Providers\ArtisanServiceProvider'
],

Override Doc View Templates

If you want to override the default view templates, run the artisan publish command., _(*8)

$ php artisan vendor:publish

This will create a vendor/api-autodoc/views/ directory in the resources directory of your Lumen/Laravel installation. Api AutoDoc will load those templates instead of its defaults., _(*9)

Usage

In your application's routes.php file, add a docCategory parameter to the route array., _(*10)

Example

    $app->get('some_resource', [
        'uses' => 'App\Http\Controllers\SomeResourceController@index',
        'docCategory' => 'Some Resource'
    ]);

You can see your autogenerated API documentation by going to the /docs page of your site., _(*11)

Example

    http://api.mywebservice.com/docs

License

MIT © Rabble + Rouser, _(*12)