Latrell / Swagger by Latrell

Swagger for Laravel 5
61,190
42
2
Package Data
Maintainer Username: Latrell
Maintainer Contact: i@latrell.me (Latrell Chan)
Package Create Date: 2014-07-09
Package Last Update: 2018-12-06
Language: HTML
License: MIT
Last Refreshed: 2024-03-28 03:00:45
Package Statistics
Total Downloads: 61,190
Monthly Downloads: 129
Daily Downloads: 3
Total Stars: 42
Total Watchers: 2
Total Forks: 19
Total Open Issues: 11

Swagger

For Laravel 4, please use the 0.3 branch!

Swagger for Laravel 5

This package combines swagger-php and swagger-ui into one Laravel-friendly package.

When you run your app in debug mode, Swagger will scan your Laravel app folder, generate swagger json files and deposit them to the docs-dir folder (default is "docs"). Files are then served by swagger-ui under the api-docs director.

Installation

composer require latrell/swagger dev-master

Update your packages with composer update or install with composer install.

Usage

To use the Swagger Service Provider, you must register the provider when bootstrapping your Laravel application. There are essentially two ways to do this.

Find the providers key in config/app.php and register the Swagger Service Provider.

    'providers' => [
        // ...
        'Latrell\Swagger\SwaggerServiceProvider',
    ]

Run php artisan vendor:publish to push swagger-ui to your public folder and publish the config file.

Config file config/latrell-swagger.php is the primary way you interact with Swagger.

Example