PHPackages                             ntgnn/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. ntgnn/swagger

ActiveLibrary

ntgnn/swagger
=============

A swagger helper

1.1.3(4y ago)03792MITPHPPHP &gt;=7.1.3CI failing

Since May 15Pushed 4y ago1 watchersCompare

[ Source](https://github.com/ntgnn/swagger)[ Packagist](https://packagist.org/packages/ntgnn/swagger)[ RSS](/packages/ntgnn-swagger/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (2)Versions (8)Used By (0)

ntgnn/swagger
-------------

[](#ntgnnswagger)

Yet another tool for documenting laravel-based APIs with OpenApi/Swagger. This package is highly inspired by great [DarkaOnLine/L5-Swagger](https://github.com/DarkaOnLine/L5-Swagger) and also wraps [zircote/swagger-php](https://github.com/zircote/swagger-php) and [swagger-api/swagger-ui](https://github.com/swagger-api/swagger-ui), but since we had some particular requirements plus some issues when serving the static assets for swagger-ui, we decided do take a different approach. This package only supports OpenAPI annotations, Swagger 3.0, Laravel &gt;=5.6.

To install this package in your laravel app, just use composer:

```
$ composer require ntgnn/swagger
```

After the package is loaded, it will provide you with 3 console commands: init, generate-docs and copy-assets

***Init***: this command will setup the settings file (config/swagger.php) and create a folder for swagger-related files inside your app/Http. You should run this command only once per install.

```
$ php artisan swagger:init
```

***Copy-Assets***: this command with copy the swagger-ui related files to the public folder. You should run this command only once per install.

```
$ php artisan swagger:copy-assets
```

***Generate-Docs***: this command will scan your php files and generate the json specification file to be used by the swagger ui. The json file will be located inside the public folder. You should run this command every time you want to update the json file, for instance after annotating a controller.

```
$ php artisan swagger:generate-docs
```

### Quick setup

[](#quick-setup)

1. Go to an existing laravel app or create one
2. Install the ntgnn/swagger package
3. Run the init command
4. Run the copy-assets command
5. Run the generate-docs command
6. Serve the app and browse the route /docs

###  Health Score

27

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 92% 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 ~86 days

Recently: every ~108 days

Total

6

Last Release

1704d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9e69da39c43cbfed12da1aa6f921b6f5f11910ee52aabc41e712199fbd695855?d=identicon)[ntgnn](/maintainers/ntgnn)

---

Top Contributors

[![ntgnn](https://avatars.githubusercontent.com/u/4570594?v=4)](https://github.com/ntgnn "ntgnn (23 commits)")[![EduardoBinoti](https://avatars.githubusercontent.com/u/15164313?v=4)](https://github.com/EduardoBinoti "EduardoBinoti (2 commits)")

### Embed Badge

![Health badge](/badges/ntgnn-swagger/health.svg)

```
[![Health](https://phpackages.com/badges/ntgnn-swagger/health.svg)](https://phpackages.com/packages/ntgnn-swagger)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
