PHPackages blockpit/laravel-swagger - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. blockpit/laravel-swagger ActiveLibrary blockpit/laravel-swagger ======================== Auto generates the swagger documentation for a laravel project 1.0.2(6y ago)21.5k[3 PRs](https://github.com/blockpit/laravel-swagger/pulls)MITPHP Since Mar 31Pushed 3y ago1 watchersCompare [ Source](https://github.com/blockpit/laravel-swagger)[ Packagist](https://packagist.org/packages/blockpit/laravel-swagger)[ RSS](/packages/blockpit-laravel-swagger/feed)WikiDiscussions master Synced today READMEChangelog (3)Dependencies (4)Versions (8)Used By (0) [![Build Status](https://camo.githubusercontent.com/c35a93116cf81ec498b62f72f3bec81dc7ab9b5d8dd85e0768d98e4bb4151544/68747470733a2f2f7472617669732d63692e636f6d2f626c6f636b7069742f6c61726176656c2d737761676765722e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/blockpit/laravel-swagger) Laravel Swagger =============== [](#laravel-swagger) This package scans your laravel project's routes and auto generates a Swagger 2.0 documentation for you. If you inject Form Request classes in your controller's actions as request validation, it will also generate the parameters for each request that has them. It will take into account wether the request is a GET/HEAD/DELETE or a POST/PUT/PATCH request and make its best guess as to the type of parameter object it should generate. It will also generate the path parameters if your route contains them. Finally, this package will also scan any documentation you have in your action methods and add it as summary and description to that path, along with any appropriate annotations such as @deprecated. One thing to note is this library leans on being explicit. It will choose to include keys even if they have a default. For example it chooses to say a route has a deprecated value of false rather than leaving it out. I believe this makes reading the documentation easier by not leaving important information out. The file can be easily cleaned up afterwards if the user chooses to leave out the defaults. Installation ------------ [](#installation) The package can easily be installed by running `composer require blockpit/laravel-swagger` in your project's root folder. If you are running a version of Laravel < 5.5 also make sure you add `blockpit\LaravelSwagger\SwaggerServiceProvider::class` to the `providers` array in `config/app.php`. This will register the artisan command that will be available to you. You can also override the default config provided by the application by running `php artisan vendor:publish --provider "blockpit\LaravelSwagger\SwaggerServiceProvider"` in your projects root and change the configuration in the new `config/laravel-swagger.php` file created. Usage ----- [](#usage) Generating the swagger documentation is easy, simply run `php artisan laravel-swagger:generate` in your project root. Keep in mind the command will simply print out the output in your console. If you want the docs saved in a file you can reroute the output like so: `php artisan laravel-swagger:generate > swagger.json` If you wish to generate docs for a subset of your routes, you can pass a filter using `--filter`, for example: `php artisan laravel-swagger:generate --filter="/api"` By default, laravel-swagger prints out the documentation in json format, if you want it in YAML format you can override the format using the `--format` flag. Make sure to have the yaml extension installed if you choose to do so. Format options are: `json` `yaml` Example ------- [](#example) Say you have a route `/api/users/{id}` that maps to `UserController@show` Your sample controller might look like this: ``` /** * Return all the details of a user * * Returns the user's first name, last name and address * Please see the documentation [here](https://example.com/users) for more information * * @deprecated */ class UserController extends Controller { public function show(UserShowRequest $request, $id) { return User::find($id); } } ``` And the FormRequest class might look like this: ``` class UserShowRequest extends FormRequest { public function rules() { return [ 'fields' => 'array' 'show_relationships' => 'boolean|required' ]; } } ``` Running `php artisan laravel-swagger:generate > swagger.json` will generate the following file: ``` { "swagger": "2.0", "info": { "title": "Laravel", "description": "Test", "version": "1.0.1" }, "host": "http:\/\/localhost", "basePath": "\/", "paths": { "\/api\/user\/{id}": { "get": { "summary": "Return all the details of a user", "description": "Returns the user's first name, last name and address Please see the documentation [here](https://example.com/users) for more information", "deprecated": true "responses": { "200": { "description": "OK" } }, "parameters": [ { "in": "path", "name": "id", "type": "integer", "required": true, "description": "" }, { "in": "query", "name": "fields", "type": "array", "required": false, "description": "" }, { "in": "query", "name": "show_relationships", "type": "boolean", "required": true, "description": "" } ] }, ... } } } ``` ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity18 Limited adoption so far Community12 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 57.1% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~1 days Total 3 Last Release 2228d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/4d4c86e72f0796336860d5a69f9a60eaf7b9d3c356d585b704a426eb5eacc9ac?d=identicon)[blockpit](/maintainers/blockpit) --- Top Contributors [![mtrajano](https://avatars.githubusercontent.com/u/4333381?v=4)](https://github.com/mtrajano "mtrajano (28 commits)")[![fweinrich](https://avatars.githubusercontent.com/u/3958248?v=4)](https://github.com/fweinrich "fweinrich (15 commits)")[![overint](https://avatars.githubusercontent.com/u/16414140?v=4)](https://github.com/overint "overint (4 commits)")[![bav55](https://avatars.githubusercontent.com/u/2253306?v=4)](https://github.com/bav55 "bav55 (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/blockpit-laravel-swagger/health.svg) ``` [![Health](https://phpackages.com/badges/blockpit-laravel-swagger/health.svg)](https://phpackages.com/packages/blockpit-laravel-swagger) ``` ### Alternatives [nelmio/api-doc-bundle Generates documentation for your REST API from attributes 2.3k63.6M232](/packages/nelmio-api-doc-bundle)[craftcms/cms Craft CMS 3.6k3.6M2.6k](/packages/craftcms-cms)[symfony/serializer-pack A pack for the Symfony serializer 1.1k28.2M219](/packages/symfony-serializer-pack)[googleads/googleads-php-lib Google Ad Manager SOAP API Client Library for PHP 67410.3M25](/packages/googleads-googleads-php-lib)[humbug/box Fast, zero config application bundler with PHARs. 1.3k801.5k67](/packages/humbug-box)[thecodingmachine/graphqlite Write your GraphQL queries in simple to write controllers (using webonyx/graphql-php). 5723.1M30](/packages/thecodingmachine-graphqlite) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)