PHPackages                             purple-orca/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. [Security](/categories/security)
4. /
5. purple-orca/laravel-doctor

ActiveLibrary[Security](/categories/security)

purple-orca/laravel-doctor
==========================

High-signal health checks for Laravel apps. Run php artisan doctor to catch deploy blockers, security drift, and production footguns.

v0.1.0(1mo ago)134↓80%MITPHPPHP ^8.1

Since Jun 10Pushed 1mo agoCompare

[ Source](https://github.com/PURPLE-ORCA/LARAVEL-DOCTOR)[ Packagist](https://packagist.org/packages/purple-orca/laravel-doctor)[ Docs](https://github.com/PURPLE-ORCA/LARAVEL-DOCTOR)[ RSS](/packages/purple-orca-laravel-doctor/feed)WikiDiscussions main Synced 1w ago

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

Laravel Doctor
==============

[](#laravel-doctor)

> Ship clean. `php artisan doctor` first.

[![Latest Version on Packagist](https://camo.githubusercontent.com/c7148498d196f7968a4fa076955a06fec8a2bf304251864523bee4cda6f4afa7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f707572706c652d6f7263612f6c61726176656c2d646f63746f723f7374796c653d666c61742d737175617265)](https://packagist.org/packages/purple-orca/laravel-doctor)[![Tests](https://camo.githubusercontent.com/383169fbbec4806a9ad37ec44dc01f351655798d96cf34e5a463ac27eed9f45f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f505552504c452d4f5243412f4c41524156454c2d444f43544f522f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/PURPLE-ORCA/LARAVEL-DOCTOR/actions?query=workflow%3Arun-tests+branch%3Amain)[![MIT License](https://camo.githubusercontent.com/ee89acb3fe4cc332e276b495c0a55689030fcd6da242be3fc25042bdff04c84d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f707572706c652d6f7263612f6c61726176656c2d646f63746f723f7374796c653d666c61742d737175617265)](LICENSE.md)

Deterministically scans your Laravel app for schema drift, N+1 queries, security holes, queue health issues, and more checks — before they hit production. Works with all Laravel versions (11, 12, 13).

*Not affiliated with or endorsed by Laravel LLC.*

Quick start
-----------

[](#quick-start)

```
composer require purple-orca/laravel-doctor --dev
php artisan doctor
```

Want the full picture?

```
php artisan doctor --all
```

What it catches
---------------

[](#what-it-catches)

CheckWhat it catchesSchema DriftCode that references columns your DB doesn't haveN+1 QueriesRelation-in-loop and Blade N+1 patternsRoute MiddlewareMissing `auth`, duplicate route namesAuthenticated MediaPublic download endpoints, unsigned URLsQueue Health`sync` misconfig, stale jobs, Horizon mismatchUnique Constraints`unique` rules not backed by a DB indexMigration StatusPending migrations before deployScheduler CronScheduled work with no cron wiring*(+ 19 more)*Environment, security, performance, infrastructureSee [docs/CHECKS.md](docs/CHECKS.md) for the full catalog.

Run in CI
---------

[](#run-in-ci)

```
- name: Laravel Doctor
  run: php artisan doctor --json
```

Exit code `1` on any failing check — perfect for blocking PRs.

Configuration
-------------

[](#configuration)

Laravel Doctor works out of the box. To add custom checks or customize:

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

Custom checks
-------------

[](#custom-checks)

Implement `DoctorCheck` and register it in `config/doctor.php`:

```
final class MyCheck implements DoctorCheck
{
    public function run(): DoctorCheckResult
    {
        // ...
    }
}
```

See [docs/CUSTOM\_CHECKS.md](docs/CUSTOM_CHECKS.md) for examples.

Commands
--------

[](#commands)

CommandDescription`php artisan doctor`Show warnings/errors + score`php artisan doctor --all`Show all 27 checks`php artisan doctor --json`Machine-readable JSON output`php artisan doctor --category=security`Run one category onlyLicense
-------

[](#license)

MIT. See [LICENSE.md](LICENSE.md).

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance90

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity32

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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

45d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/192037893?v=4)[EL MOUSSAOUI MOHAMMED](/maintainers/PURPLE-ORCA)[@PURPLE-ORCA](https://github.com/PURPLE-ORCA)

---

Top Contributors

[![PURPLE-ORCA](https://avatars.githubusercontent.com/u/192037893?v=4)](https://github.com/PURPLE-ORCA "PURPLE-ORCA (30 commits)")

---

Tags

laravelsecurityperformanceartisanqualitydoctorscorehealth check

###  Code Quality

TestsPest

### Embed Badge

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

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

###  Alternatives

[laravel/octane

Supercharge your Laravel application's performance.

4.0k26.6M232](/packages/laravel-octane)[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.7k38.9k](/packages/matomo-matomo)[laravel/nightwatch

The official Laravel Nightwatch package.

36910.1M39](/packages/laravel-nightwatch)

PHPackages © 2026

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