kubotak-is/l5-swagger

Swagger integration to Laravel 5

Saturday, November 11, 2017
by kubotak-is
Repository
1 Watchers
0 Stars
7 Installations

PHP
0 Dependents
0 Suggesters
90 Forks
0 Open issues
37 Versions
0 % Grown

The README.md

, _(*1)

L5 Swagger

Swagger 2.0 for Laravel >=5.1, _(*2)

This package is a wrapper of Swagger-php and swagger-ui adapted to work with Laravel 5., _(*3)

Installation

For Swagger 2.0, _(*4)

Laravel	Swagger UI	OpenAPI Spec compatibility	L5-Swagger
5.1.x	2.2	1.1, 1.2, 2.0	`php composer require "darkaonline/l5-swagger:~3.0"`
5.2.x	2.2	1.1, 1.2, 2.0	`php composer require "darkaonline/l5-swagger:~3.0"`
5.3.x	2.2	1.1, 1.2, 2.0	`php composer require "darkaonline/l5-swagger:~3.0"`
5.4.x	2.2	1.1, 1.2, 2.0	`php composer require "darkaonline/l5-swagger:~4.0"`
5.4.x	3	2.0	`php composer require "darkaonline/l5-swagger:5.4.*"`
5.5.x	3	2.0	`php composer require "darkaonline/l5-swagger:5.5.*"`

For Swagger 1.0, _(*5)

composer require darkaonline/l5-swagger

Open your AppServiceProvider (located in app/Providers) and add this line in register function, _(*6)

$this->app->register(\L5Swagger\L5SwaggerServiceProvider::class);

or open your config/app.php and add this line in providers section, _(*7)

L5Swagger\L5SwaggerServiceProvider::class,

For Laravel 5.5, no need to manually add L5SwaggerServiceProvider into config. It uses package auto discovery feature., _(*8)

Changes in 5.0

Swagger UI 3.
Configuration changes.
Assets dependency dropped. Now includes from composer package.
See migration

Changes in 4.0

Laravel 5.4 support

Changes in 3.2.1

Middleware support for routes (#43) (@tantam)

Changes in 3.2

Allow to change swagger base path in generation process
Allow to define constants in config which can be used later in annotations
Tests fix form L5.3 and PHP >= 5.6
Update swagger UI to 2.1.5

Changes in 3.1

Closure routes moved to controller and got names (thanks to @bbs-smuller #19)
Added option to rename generated API .json file name

Changes in 3.0

More accurate naming and structured config
Swagger UI - v2.1.4
Tests

Migrate from 2.0 to 3.0

Replace $this->app->register('\Darkaonline\L5Swagger\L5SwaggerServiceProvider'); with $this->app->register(\L5Swagger\L5SwaggerServiceProvider::class); in your AppServiceProvider or add \L5Swagger\L5SwaggerServiceProvider::class line in your config/app.php file
Run l5-swagger:publish-config to publish new config and make your changes if needed
Remove public/vendor/l5-swagger directory
Remove resources/views/vendor/l5-swagger directory
Run l5-swagger:publish-assets to publish new swagger-ui assets
Run l5-swagger:publish-views to publish new views

Migrate from 3.0|4.0 to 5.0

Remove config/l5-swagger.php file (make a copy if needed)
Remove public/vendor/l5-swagger directory
Remove resources/views/vendor/l5-swagger directory
Run l5-swagger:publish to publish new swagger-ui view and configuration
Edit your config/l5-swagger.php file

Configuration

Run l5-swagger:publish to publish everything
Run l5-swagger:publish-config to publish configs (config/l5-swagger.php)
Run l5-swagger:publish-assets to publish swagger-ui to your public folder (public/vendor/l5-swagger)
Run l5-swagger:publish-views to publish views (resources/views/vendor/l5-swagger) - only for versions <= 4.0
Run l5-swagger:generate to generate docs or set generate_always param to true in your config or .env file

Swagger-php

The actual Swagger spec is beyond the scope of this package. All L5-Swagger does is package up swagger-php and swagger-ui in a Laravel-friendly fashion, and tries to make it easy to serve. For info on how to use swagger-php look here. For good examples of swagger-php in action look here., _(*9)

Support on Beerpay

Hey dude! Help me out for a couple of :beers:!, _(*10)

, _(*11)

The Versions

11/11 2017

dev-master

9999999-dev

Swagger integration to Laravel 5

library l5-swagger

Swagger integration to Laravel 5

kubotak-is/l5-swagger

The README.md

L5 Swagger

Installation

Changes in 5.0

Changes in 4.0

Changes in 3.2.1

Changes in 3.2

Changes in 3.1

Changes in 3.0

Migrate from 2.0 to 3.0

Migrate from 3.0|4.0 to 5.0

Configuration

Swagger-php

Support on Beerpay

The Versions

dev-master

The Requires

The Development Requires

by Darius Matulionis

by Kenjiro Kubota

5.5.2.1

The Requires

The Development Requires

by Darius Matulionis

by Kenjiro Kubota

5.5.2

The Requires

The Development Requires

by Darius Matulionis

5.5.1

The Requires

The Development Requires

by Darius Matulionis

5.5.0

The Requires

The Development Requires

by Darius Matulionis

5.4.x-dev

The Requires

The Development Requires

by Darius Matulionis

5.4.0

The Requires

The Development Requires

by Darius Matulionis

5.0.4

The Requires

The Development Requires

by Darius Matulionis

5.0.3

The Requires

The Development Requires

by Darius Matulionis

5.0.2

The Requires

The Development Requires

by Darius Matulionis

5.0.1

The Requires

The Development Requires

by Darius Matulionis

5.0

The Requires

The Development Requires

by Darius Matulionis

3.2.3

The Requires

The Development Requires

by Darius Matulionis

3.x-dev

The Requires

The Development Requires

by Darius Matulionis

3.2.2

The Requires

The Development Requires

by Darius Matulionis