PHPackages                             devski/laravel-doctor - 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. devski/laravel-doctor

ActiveLibrary

devski/laravel-doctor
=====================

An open-source diagnostics and repair toolkit for Laravel applications.

v1.0.3(yesterday)012↑2650%MITPHP ^8.1 || ^8.2 || ^8.3

Since Jul 19Compare

[ Source](https://github.com/abu-saied-mondal/laravel-doctor)[ Packagist](https://packagist.org/packages/devski/laravel-doctor)[ RSS](/packages/devski-laravel-doctor/feed)WikiDiscussions Synced today

READMEChangelogDependencies (4)Versions (5)Used By (0)

Laravel Doctor 🩺
================

[](#laravel-doctor-)

[![Packagist Version](https://camo.githubusercontent.com/48ef168cf31ea292a34efdab7988daad9cdd316630b740318c15eaffee55f33f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f646576736b692f6c61726176656c2d646f63746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/devski/laravel-doctor)[![Total Downloads](https://camo.githubusercontent.com/b90b031ce4334feb93d8c3a8b401054bc9e574de22e9b8dd956d571a90f266d7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f646576736b692f6c61726176656c2d646f63746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/devski/laravel-doctor)[![License](https://camo.githubusercontent.com/c13ae35e0330a0b0068b90dd0223519afaf1bcb3be3975afb1a2ec9578c6b826/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f646576736b692f6c61726176656c2d646f63746f722e7376673f7374796c653d666c61742d737175617265)](https://github.com/devski/laravel-doctor/blob/main/LICENSE.md)

> **Laravel Doctor doesn't just tell developers what's broken. It explains why it's broken, what the impact is, whether it's safe to fix, and can repair it automatically.**

---

Laravel Doctor is an open-source diagnostics and repair toolkit for Laravel applications. It provides a health check platform to inspect, explain, repair, and optimize your application states with surgical precision.

---

🚀 Features
----------

[](#-features)

- 🔍 **Comprehensive Diagnostics**: Automatically scan storage, permissions, databases, queues, cache, configurations, keys, and mail configurations.
- 💡 **Contextual Explanations**: Understand the exact consequences and risks of failed checks.
- 🛠️ **Safe Auto-Repairs**: Instantly apply safe, surgical fixes for common configuration and system issues.
- 📊 **Flexible Reporting**: Output diagnostics in beautifully formatted CLI tables, markdown documentation, or structured JSON.
- ⚡ **Production & Performance Modes**: Separate specialized rules for live systems and performance speed-ups.

---

📦 Installation
--------------

[](#-installation)

Install the package via Composer:

```
composer require devski/laravel-doctor --dev
```

You can publish the configuration file using:

```
php artisan vendor:publish --tag="doctor-config"
```

---

💻 Commands
----------

[](#-commands)

### 1. Doctor Scan

[](#1-doctor-scan)

Scan your Laravel application for standard health issues:

```
php artisan doctor:scan
```

### 2. Doctor Interactive Repair

[](#2-doctor-interactive-repair)

Interactive tool to safely repair detected issues:

```
php artisan doctor:repair
```

### 3. Production Validator

[](#3-production-validator)

Validate environment flags, secure headers, permissions, and caches for a production release:

```
php artisan doctor:production
```

### 4. Performance Optimizer

[](#4-performance-optimizer)

Scan your application for database, configuration, route, and view caching optimizations:

```
php artisan doctor:performance
```

### 5. Export Report

[](#5-export-report)

Generate and save a detailed report:

```
php artisan doctor:report --format=markdown
```

---

📸 Screenshots
-------------

[](#-screenshots)

*CLI Interactive Scan Output:*

```
+------------------+----------+----------------------------+-----------------------+
| Check            | Status   | Issue                      | Repair Available?     |
+------------------+----------+----------------------------+-----------------------+
| App Key          | FAILED   | APP_KEY is missing         | Yes (doctor:repair)   |
| Storage Link     | FAILED   | Public symlink is missing  | Yes (doctor:repair)   |
| DB Connection    | PASSED   | Connected successfully     | -                     |
+------------------+----------+----------------------------+-----------------------+

```

---

🤝 Contributing
--------------

[](#-contributing)

Thank you for considering contributing to Laravel Doctor! Please read our [Contributing Guide](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.

📄 License
---------

[](#-license)

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

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance100

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

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

4

Last Release

1d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2e958b8bc092bc7a8006e617439c74c3e37e30dc71554dc60f85dd93526149df?d=identicon)[Abusaied](/maintainers/Abusaied)

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/devski-laravel-doctor/health.svg)

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

###  Alternatives

[laravel/sail

Docker files for running a basic Laravel application.

1.9k205.7M1.3k](/packages/laravel-sail)[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M238](/packages/laravel-ai)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

77022.3M180](/packages/laravel-mcp)[tallstackui/tallstackui

TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications.

726176.2k14](/packages/tallstackui-tallstackui)[mike-bronner/laravel-model-caching

Automatic caching for Eloquent models.

2.4k96.5k1](/packages/mike-bronner-laravel-model-caching)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)

PHPackages © 2026

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