PHPackages                             macerd/laravel-request-docs - 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. [Utility & Helpers](/categories/utility)
4. /
5. macerd/laravel-request-docs

ActiveLibrary[Utility & Helpers](/categories/utility)

macerd/laravel-request-docs
===========================

Automatically generate Laravel docs from request rules, controllers and routes

1.22(4y ago)159MITBladePHP ^7.4|^8.0

Since Aug 19Pushed 3y agoCompare

[ Source](https://github.com/macerd/laravel-request-docs)[ Packagist](https://packagist.org/packages/macerd/laravel-request-docs)[ Docs](https://github.com/rakutentech/laravel-request-docs)[ RSS](/packages/macerd-laravel-request-docs/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (11)Versions (27)Used By (0)

 [ ![Laravel Request Docs](https://camo.githubusercontent.com/fd6650e2027d7265b156713bccd4653964f90d3efa40d4c56f3babab02648373/68747470733a2f2f696d6775722e636f6d2f396544545561492e706e67) ](https://github.com/rakutentech/laravel-request-docs)

 The Hassle-Free automatic API documentation generation for Laravel.
 A Swagger alernative.
 Supports Open API 3.0.0

**Fast:** Install on any Laravel Project

**Hassle Free:** Auto Generate API Documentation for request rules and parameters

**Analyze:** In built SQL query time analyzer, response time and headers output.

**Supports:** Postman and OpenAPI 3.0.0 exports.

Features
--------

[](#features)

- Automatic routes fetching from Laravel Routes
- Automatic rules fetching from injected Request
- Support for Authorization Headers
- Support for SQL query, response time and memory consumption by request on Laravel
- Intelligent auto request builder using `faker.js`
- Display extra documentation using markdown
- Export laravel API, routes, rules and documentation to Postman and OpenAPI 3.0.0

Read on Medium
==============

[](#read-on-medium)

Automatically generate api documentation for Laravel without writing annotations.

Read more:

Requirements
------------

[](#requirements)

LangVersionsPHP7.4 or 8.0 or 8.1Laravel6.\* or 8.\* or 9.\*Installation
============

[](#installation)

You can install the package via composer:

```
composer require rakutentech/laravel-request-docs --dev
```

You can publish the config file with:

```
php artisan vendor:publish --tag=request-docs-config
```

Usage
=====

[](#usage)

Dashboard
---------

[](#dashboard)

View in the browser on `/request-docs/`

Generate a static HTML and open api specification

```
php artisan lrd:generate
```

Docs HTML is generated inside `docs/`.

Just want Open API
------------------

[](#just-want-open-api)

View in the browser on `/request-docs/?openapi=true`

Design pattern
==============

[](#design-pattern)

In order for this plugin to work, you need to follow the design pattern by injecting the request class inside the controller. For extra documentation you can use markdown inside your controller method as well.

[![Design pattern](https://camo.githubusercontent.com/c8df93a2782634c01caca681fdf553fcddd534d3875b84f3122326b42fb292c7/68747470733a2f2f696d6775722e636f6d2f79586a71336a702e706e67)](https://camo.githubusercontent.com/c8df93a2782634c01caca681fdf553fcddd534d3875b84f3122326b42fb292c7/68747470733a2f2f696d6775722e636f6d2f79586a71336a702e706e67)

Screenshots
===========

[](#screenshots)

**Generated API documentation**

[![Preview](https://camo.githubusercontent.com/191d4984dfe4bca9d7d0799c2d39c0c7936f5493b778dc336b12318adb7f1de1/68747470733a2f2f696d6775722e636f6d2f384476424268732e706e67)](https://camo.githubusercontent.com/191d4984dfe4bca9d7d0799c2d39c0c7936f5493b778dc336b12318adb7f1de1/68747470733a2f2f696d6775722e636f6d2f384476424268732e706e67)

**Try API**

[![Preview](https://camo.githubusercontent.com/09e8a31bca324b79997e4e6bee5c3febc303f78b9216a3003d9006be52840c92/68747470733a2f2f696d6775722e636f6d2f6b634b56537a6d2e706e67)](https://camo.githubusercontent.com/09e8a31bca324b79997e4e6bee5c3febc303f78b9216a3003d9006be52840c92/68747470733a2f2f696d6775722e636f6d2f6b634b56537a6d2e706e67)

**SQL query profile**

[![Preview](https://camo.githubusercontent.com/40d371037b408ee06f38c40d1a454500aceeca04f121b875e25672e35b179890/68747470733a2f2f696d6775722e636f6d2f79386a54336a6a2e706e67)](https://camo.githubusercontent.com/40d371037b408ee06f38c40d1a454500aceeca04f121b875e25672e35b179890/68747470733a2f2f696d6775722e636f6d2f79386a54336a6a2e706e67)

**Response profile**

[![Preview](https://camo.githubusercontent.com/ccf7ae509f81da79e2b05eaf202619acf4459745ae8c951cf83d8488107fba1c/68747470733a2f2f696d6775722e636f6d2f55304a653935362e706e67)](https://camo.githubusercontent.com/ccf7ae509f81da79e2b05eaf202619acf4459745ae8c951cf83d8488107fba1c/68747470733a2f2f696d6775722e636f6d2f55304a653935362e706e67)

**Customize Headers**

[![Preview](https://camo.githubusercontent.com/969af0f324c4ea83efcc0eb422ecb14e919b2a0c1f1e0fe0ef26c66ff2b98b32/68747470733a2f2f696d6775722e636f6d2f357964745264382e706e67)](https://camo.githubusercontent.com/969af0f324c4ea83efcc0eb422ecb14e919b2a0c1f1e0fe0ef26c66ff2b98b32/68747470733a2f2f696d6775722e636f6d2f357964745264382e706e67)

Extra
=====

[](#extra)

You write extra documentation in markdown which will be rendered as HTML on the dashboard. Example of using it in controller

```
    /**
     * @lrd:start
     * #Hello markdown
     * ## Documentation for /my route
     * @lrd:end
     */
    public function index(MyIndexRequest $request): Resource
    {
```

Custom Params
=============

[](#custom-params)

You write extra params with rules with @QAparam comment line

```
    /**
     * @QAparam search string
     */
    public function index(MyIndexRequest $request): Resource
    {
```

```
    /**
     * @QAparam search string nullable max:32
     */
    public function index(MyIndexRequest $request): Resource
    {
```

Testing
=======

[](#testing)

```
./vendor/bin/phpunit
```

Linting
=======

[](#linting)

```
./vendor/bin/phpcs --standard=phpcs.xml --extensions=php --ignore=tests/migrations config/ src/
```

Fixing lints

```
./vendor/bin/php-cs-fixer fix src/
./vendor/bin/php-cs-fixer fix config/
```

Changelog
=========

[](#changelog)

- Initial Release
- v1.9 Added improvements such as status code, response headers, custom request headers and fixed issues reported by users
- v1.10 Show PHP memory usage, gzip encoding fix
- v1.12 Bug Fix of id, and Laravel 9 support
- v1.13 Laravel 9 support
- v1.15 Adds Filter and fall back to regexp upon Exception
- v1.17 Donot restrict to FormRequest
- v1.18 Fix where prism had fixed height. Allow text area resize.
- v1.18 Updated UI and pushed unit tests
- v1.19 Exception -> Throwable for type error
- v1.20 Feature support open api 3.0.0 #10
- v1.21 Abililty to add custom params
- v1.22 Boolean|File|Image support
- v1.22 Boolean|File|Image support
- v1.23 Bug fix for lrd doc block #76

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 80.3% 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 ~10 days

Recently: every ~3 days

Total

23

Last Release

1534d ago

PHP version history (2 changes)1.0PHP ^7.3|^7.4|^8.0

1.12PHP ^7.4|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/24268764fc213f77043974bb31ec082b3a8f852ec69732a3839e8078d160286d?d=identicon)[emanueltotem](/maintainers/emanueltotem)

---

Top Contributors

[![kevincobain2000](https://avatars.githubusercontent.com/u/629055?v=4)](https://github.com/kevincobain2000 "kevincobain2000 (98 commits)")[![macerd](https://avatars.githubusercontent.com/u/16547271?v=4)](https://github.com/macerd "macerd (7 commits)")[![kitloong](https://avatars.githubusercontent.com/u/7660346?v=4)](https://github.com/kitloong "kitloong (3 commits)")[![DeDmytro](https://avatars.githubusercontent.com/u/13836815?v=4)](https://github.com/DeDmytro "DeDmytro (3 commits)")[![Mdhesari](https://avatars.githubusercontent.com/u/28428724?v=4)](https://github.com/Mdhesari "Mdhesari (3 commits)")[![rawahamid](https://avatars.githubusercontent.com/u/27570598?v=4)](https://github.com/rawahamid "rawahamid (2 commits)")[![nimah79](https://avatars.githubusercontent.com/u/20343056?v=4)](https://github.com/nimah79 "nimah79 (2 commits)")[![digitall-it](https://avatars.githubusercontent.com/u/3578378?v=4)](https://github.com/digitall-it "digitall-it (1 commits)")[![Mello21century](https://avatars.githubusercontent.com/u/4740180?v=4)](https://github.com/Mello21century "Mello21century (1 commits)")[![cdmathukiya](https://avatars.githubusercontent.com/u/18529326?v=4)](https://github.com/cdmathukiya "cdmathukiya (1 commits)")[![farshadfakhar](https://avatars.githubusercontent.com/u/45591134?v=4)](https://github.com/farshadfakhar "farshadfakhar (1 commits)")

---

Tags

laravelrakutentechlaravel-request-docs

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/macerd-laravel-request-docs/health.svg)

```
[![Health](https://phpackages.com/badges/macerd-laravel-request-docs/health.svg)](https://phpackages.com/packages/macerd-laravel-request-docs)
```

###  Alternatives

[rakutentech/laravel-request-docs

Automatically generate Laravel docs from request rules, controllers and routes

7821.3M2](/packages/rakutentech-laravel-request-docs)[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.3M42](/packages/spatie-laravel-pdf)[codewithdennis/filament-select-tree

The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths.

328482.0k25](/packages/codewithdennis-filament-select-tree)[nativephp/desktop

NativePHP for Desktop

38133.6k8](/packages/nativephp-desktop)[worksome/exchange

Check Exchange Rates for any currency in Laravel.

124581.3k](/packages/worksome-exchange)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3913.7k](/packages/rawilk-profile-filament-plugin)

PHPackages © 2026

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