Download the PHP package darkaonline/swagger-lume without Composer
On this page you can find all versions of the php package darkaonline/swagger-lume. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download darkaonline/swagger-lume
More information about darkaonline/swagger-lume
Files in darkaonline/swagger-lume
Package swagger-lume
Short Description OpenApi or Swagger integration to Lumen
License MIT
Informations about the package swagger-lume
SwaggerLume
Swagger 2.0-3.0 for Lumen
This package is a wrapper of Swagger-php and swagger-ui adapted to work with Lumen.
Installation
Lumen | Swagger UI | OpenAPI Spec compatibility | L5-Swagger |
---|---|---|---|
5.0 - 5.3 | 2.2 | 1.1, 1.2, 2.0 | |
5.4.x | 2.2 | 1.1, 1.2, 2.0 | |
5.4.x | 3 | 2.0 | |
5.5.x | 3 | 2.0 | |
5.6 - 5.7 | 3 | 2.0, 3.0 | |
6.0 | 3 | 2.0, 3.0 | |
7.0 | 3 | 2.0, 3.0 | |
8.0 | 3 | 2.0, 3.0 | |
9.0 | 3 | 2.0, 3.0 | |
10.0 | 3 | 2.0, 3.0 |
- Open your
bootstrap/app.php
file and:
uncomment this line (around line 26) in Create The Application
section:
add this line before Register Container Bindings
section:
add this line in Register Service Providers
section:
- Run
php artisan swagger-lume:publish-config
to publish configs (config/swagger-lume.php
) - Make configuration changes if needed
- Run
php artisan swagger-lume:publish
to publish everything
Using OpenApi 3.0 Specification
If you would like to use latest OpenApi specifications (originally known as the Swagger Specification) in your project you should:
-
Explicitly require
swagger-php
version 3.* in your projects composer by running: - Set environment variable
SWAGGER_VERSION
to 3.0 in your.env
file:
or in your config/l5-swagger.php
:
- Use examples provided here: https://github.com/zircote/swagger-php/tree/3.x/Examples/petstore-3.0
Configuration
- Run
php artisan swagger-lume:publish-config
to publish configs (config/swagger-lume.php
) - Run
php artisan swagger-lume:publish-views
to publish views (resources/views/vendor/swagger-lume
) - Run
php artisan swagger-lume:publish
to publish everything - Run
php artisan swagger-lume:generate
to generate docs
Changes in 3.0
- Swagger UI 3.
- Configuration changes.
- Assets dependency dropped. Now includes from composer package.
- See migration from 2.0 to 3.0
Changes in 2.0
- Lumen 5.4 support
- Swagger UI 2.2.8
Migrate from 2.0 to 3.0 or 5.5
- Remove
config/swagger-lume.php
file (make a copy if needed) - Remove
public/vendor/swagger-lume
directory - Remove
resources/views/vendor/swagger-lume
directory - Run
swagger-lume:publish
to publish new swagger-ui view and configuration - Edit your
config/swagger-lume.php
file
Swagger-php
The actual Swagger spec is beyond the scope of this package. All SwaggerLume 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.
Important: Make sure that you add the include statement on all pages with annotations!
Support on Beerpay
Hey dude! Help me out for a couple of :beers:!
All versions of swagger-lume with dependencies
laravel/lumen-framework Version ~6.0 || ~7.0 || ^8.0 || ^9.0 || ^10.0 || ^11.0
zircote/swagger-php Version ~2.0 || 3.* || 4.*
swagger-api/swagger-ui Version ^3.0 || ^4.0
symfony/yaml Version ^4.0 || ^5.0 || ^6.2
doctrine/annotations Version ^1.0 || ^2.0