PHPackages                             julfiker/swagger-laravel - 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. [API Development](/categories/api)
4. /
5. julfiker/swagger-laravel

ActiveLibrary[API Development](/categories/api)

julfiker/swagger-laravel
========================

Api document based on swagger

v1.0.1(7y ago)3205HTMLPHP >=5.5.9

Since Nov 1Pushed 7y ago1 watchersCompare

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

READMEChangelog (1)Dependencies (1)Versions (4)Used By (0)

swagger api documentation for laravel
=====================================

[](#swagger-api-documentation-for-laravel)

Api documentation based on swagger for Laravel framework. It would serve run time environment with the ui based on swagger ui latest released. You can test and documenting about the every each action and request object along with each properties you can explain. Just annotation based very simple. You can manage everything as you needs.

*Note: - only for laravel framework. It would competitable with any lts version of laravel.*

Instuction how to use the package on laravel.
---------------------------------------------

[](#instuction-how-to-use-the-package-on-laravel)

**Install package by composer:**
`composer require julfiker/swagger-laravel`
Just run composer require command with package name. This assumes you have composer installed and available in your path as composer. Instruction to have composer .

**Post install**
Configure the service into the applicaton, Please add following into the config/app.php under the providers
`Julfiker\Swagger\SwaggerServiceProvider::class`
Then run following command
`php artisan vendor:publish`
Thats it!!!

**Usage instruction by annotation:**
Add annotations to your php files. You must need to use `@OA\Info()` only one time in any php files under the app directly. I can recomment to home or welcome page controller that it would render your application home page. Then add each controller action in the api controller class.

```
/**
 * Only one time for the application
 * @OA\Info(title="My Laravel REST API", version="1.0")
 */
 class WelcomeController {
   //Action method and others
 }

/**
 * Action method
 * @OA\Get(
 *     path="/v1/resources",
 *     @OA\Response(response="200", description="About the resources")
 * )
 */
 public function index(){
   //Your code
 }

```

For further study on annotation to use -

**Access swagger documents:**
`http://{project-url}/swagger/doc`

**Any Help?**
You can contact me if you need anything on this regards, My contacts information ~
*email:* `mail.julfiker@gmail.com`
*skype:* `eng.jewel`

Enjoy!!! 😄

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

2

Last Release

2748d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d2891c7040783336013e794b238f2389a61973e26002105f438ec1d74188601d?d=identicon)[julfiker](/maintainers/julfiker)

---

Top Contributors

[![julfiker](https://avatars.githubusercontent.com/u/3142932?v=4)](https://github.com/julfiker "julfiker (16 commits)")

### Embed Badge

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

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

###  Alternatives

[darkaonline/l5-swagger

OpenApi or Swagger integration to Laravel

2.9k34.0M112](/packages/darkaonline-l5-swagger)[darkaonline/swagger-lume

OpenApi or Swagger integration to Lumen

3372.3M3](/packages/darkaonline-swagger-lume)[jlapp/swaggervel

A great way to integrate Swagger into Laravel

492931.6k2](/packages/jlapp-swaggervel)[light/yii2-swagger

swagger intergation with yii2

154801.6k4](/packages/light-yii2-swagger)[yii2mod/yii2-swagger

Swagger Documentation Generator for Yii2 Framework

63384.7k9](/packages/yii2mod-yii2-swagger)[alt3/cakephp-swagger

Instant Swagger documentation for your CakePHP 4.x APIs

64197.3k3](/packages/alt3-cakephp-swagger)

PHPackages © 2026

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