PHPackages                             peterzaccha/swaggerator - 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. peterzaccha/swaggerator

ActiveLibrary[API Development](/categories/api)

peterzaccha/swaggerator
=======================

Swagger annotation generator

06PHP

Since Jun 4Pushed 6y agoCompare

[ Source](https://github.com/peter44322/Swaggerator)[ Packagist](https://packagist.org/packages/peterzaccha/swaggerator)[ RSS](/packages/peterzaccha-swaggerator/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

swaggerator
===========

[](#swaggerator)

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require peterzaccha/swaggerator
```

If you are using Laravel in a version < 5.5, the service provider must be registered as a next step:

```
// config/app.php
'providers' => [
    ...
    Peterzaccha\Swaggerator\SwaggeratorServiceProvider::class
];
```

You can publish L5-Swagger's config and view files into your project by running:

```
$ php artisan vendor:publish --provider "L5Swagger\L5SwaggerServiceProvider"
```

For Laravel >=5.5, no need to manually add `L5SwaggerServiceProvider` into config. It uses package auto discovery feature. Skip this if you are on >=5.5, if not:

Open your `AppServiceProvider` (located in `app/Providers`) and add this line in `register` function

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

or open your `config/app.php` and add this line in `providers` section

```
L5Swagger\L5SwaggerServiceProvider::class,
```

in .env

```
L5_SWAGGER_GENERATE_ALWAYS=true
```

Usage
-----

[](#usage)

```
php artisan swaggerator:generate TagName requestName path/to/request
```

**Parameters**

`-p|pram` to add parameters

```
php artisan swaggerator:generate TagName requestName path/to/request -pmail --pram=password
```

`--method` to add parameters

```
php artisan swaggerator:generate TagName requestName path/to/request --method=Get
```

Output
------

[](#output)

output folder `app/Document/TagName.php`

```
/**
 * @OA\Post(
 *      path="/path/to/request ",
 *      operationId="---",
 *      tags={"TagName"},
 *      summary="----",
 *      description="---",
 *      @OA\Parameter(
 *          name="email",
 *          description="----",
 *          required=true,
 *          in="path",
 *          @OA\Schema(
 *              type="integer"
 *          )
 *      ),
 *      @OA\Parameter(
 *          name="password",
 *          description="----",
 *          required=true,
 *          in="path",
 *          @OA\Schema(
 *              type="integer"
 *          )
 *      ),
 *      @OA\Response(
 *          response=200,
 *          description="successful operation"
 *       ),
 *      @OA\Response(response=400, description="Bad request"),
 *      @OA\Response(response=404, description="Resource Not Found"),
 * )
 */
```

after running the command go to

```
localost:8000/api/documentation
```

Changelog
---------

[](#changelog)

Check [CHANGELOG](CHANGELOG.md) for the changelog

Testing
-------

[](#testing)

To run tests use

```
$ composer test

```

Contributing
------------

[](#contributing)

Security
--------

[](#security)

If you discover any security related issues, please email  or use the issue tracker of GitHub.

About
-----

[](#about)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/849e8e10b6ef6e10fe19b36a55423533a9f52b5878c14ba462c9086cb033bcaf?d=identicon)[peter44322](/maintainers/peter44322)

---

Top Contributors

[![peterzaccha](https://avatars.githubusercontent.com/u/24572474?v=4)](https://github.com/peterzaccha "peterzaccha (9 commits)")

### Embed Badge

![Health badge](/badges/peterzaccha-swaggerator/health.svg)

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

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M271](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

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