PHPackages                             lanser/laravel-openapi-generator - 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. lanser/laravel-openapi-generator

ActiveLibrary[API Development](/categories/api)

lanser/laravel-openapi-generator
================================

Api swagger docs generater with spatia Laravel data

1.6.5(2y ago)4292[2 issues](https://github.com/Lanser0614/laravel-openapi-generator/issues)MITPHPPHP ^8.1

Since May 5Pushed 2y ago1 watchersCompare

[ Source](https://github.com/Lanser0614/laravel-openapi-generator)[ Packagist](https://packagist.org/packages/lanser/laravel-openapi-generator)[ RSS](/packages/lanser-laravel-openapi-generator/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (13)Used By (0)

OpenAPI Generator using Laravel Data
====================================

[](#openapi-generator-using-laravel-data)

Generate OpenAPI specification from Laravel routes and Laravel Data objects

**This repository is just fork from original. Thanks to this person.**Original `xolvio/laravel-data-openapi-generator`and this package work with `spatie/laravel-data` and `phpdocumentor/reflection-docblock`

Install
=======

[](#install)

In `composer.json` add this repository:

```
    "require": {
          "lanser/laravel-openapi-generator" : "^1.5"
    },
```

and

```
    composer update
```

Version
-------

[](#version)

Add a `app.version` config in `app.php` to set the version in the openapi specification:

```
    'version' => env('APP_VERSION', '1.0.0'),
```

Usage
=====

[](#usage)

Config
------

[](#config)

`php artisan vendor:publish --tag=openapi-generator-config`

Generate
--------

[](#generate)

`php artisan openapi:generate`

View
----

[](#view)

Swagger available at `APP_URL/api/openapi`

#### On your request

[](#on-your-request)

```
use Lanser\LaravelApiGenerator\Request\RequestData;

class UserRequest extends RequestData
{

    public function __construct(
        public string $name,
        public string $email
    )
    {
    }

    public static function rules(ValidationContext $context): array
    {
        return [
            'name' => ['required', 'string'],
            'email' => ['required', 'email'],
        ];
    }

}
```

#### On your resource

[](#on-your-resource)

```
use Lanser\LaravelApiGenerator\Response\ResponseData;

class UserResponse extends ResponseData
{

    public function __construct(
        public string $name,
        public string $email
    )
    {
    }
}
```

Example
-------

[](#example)

```
namespace App\Http\Controllers;

use App\Http\Requests\UserRequest;
use App\Response\UserResponse;
use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
use Illuminate\Foundation\Auth\User;
use Illuminate\Foundation\Validation\ValidatesRequests;
use Illuminate\Routing\Controller as BaseController;

class Controller extends BaseController
{
    use AuthorizesRequests, ValidatesRequests;

    /**
     * @param UserRequest $request
     * @return UserResponse
     */
    public function show(UserRequest $request): UserResponse
    {
        $user = User::query()->first();
        return UserResponse::from($user);
    }
}
```

### Final result

[](#final-result)

[![img.png](img.png)](img.png)

### For Rout grouping

[](#for-rout-grouping)

```
Route::group(['as' => 'user'], function () {
    Route::post('/', [Controller::class, 'show']);
});
```

### For add auth

[](#for-add-auth)

```
Route::group(['as' => 'user'], function () {
    Route::post('/', [Controller::class, 'show']);
})->middleware('auth:sanctum');
```

### If you want documenting errors you can use Attribute ErrorMessage

[](#if-you-want-documenting-errors-you-can-use-attribute-errormessage)

```
    use Lanser\LaravelApiGenerator\OpenApi\Attributes\ErrorMessage;

    #[ErrorMessage(["User not found", "User is not active"])]
    public function show(UserRequest $request): UserResponse
    {
        $user = User::query()->first();
        return UserResponse::from($user);
    }
```

Click the schema if you want see what kind of exceptions have in this route

[![img_2.png](img_2.png)](img_2.png)

###  Health Score

25

↓

LowBetter than 37% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 94.4% 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

12

Last Release

734d ago

Major Versions

0.3 → 1.52024-05-05

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/62260034?v=4)[Doniyor](/maintainers/Lanser0614)[@Lanser0614](https://github.com/Lanser0614)

---

Top Contributors

[![Lanser0614](https://avatars.githubusercontent.com/u/62260034?v=4)](https://github.com/Lanser0614 "Lanser0614 (17 commits)")[![AnvarovD](https://avatars.githubusercontent.com/u/134365517?v=4)](https://github.com/AnvarovD "AnvarovD (1 commits)")

### Embed Badge

![Health badge](/badges/lanser-laravel-openapi-generator/health.svg)

```
[![Health](https://phpackages.com/badges/lanser-laravel-openapi-generator/health.svg)](https://phpackages.com/packages/lanser-laravel-openapi-generator)
```

###  Alternatives

[echolabsdev/prism

A powerful Laravel package for integrating Large Language Models (LLMs) into your applications.

2.3k388.3k10](/packages/echolabsdev-prism)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

135192.6k5](/packages/statamic-rad-pack-runway)

PHPackages © 2026

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