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 2026-06-10 13:57 UTC

Requires

• php: ^8.1
• laravel/framework: ^10.0|^11.0|^12.0
• symfony/console: ^6.0|^7.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0
• pestphp/pest: ^2.0

MIT

• purple-orca

• performance
• security
• laravel
• quality
• artisan
• score
• doctor
• health-check

Published on Packagist.org on 2026-06-10 14:16 UTC

README

Ship clean. php artisan doctor first.

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

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

Want the full picture?

php artisan doctor --all

What it catches

Check	What it catches
Schema Drift	Code that references columns your DB doesn't have
N+1 Queries	Relation-in-loop and Blade N+1 patterns
Route Middleware	Missing auth, duplicate route names
Authenticated Media	Public download endpoints, unsigned URLs
Queue Health	sync misconfig, stale jobs, Horizon mismatch
Unique Constraints	unique rules not backed by a DB index
Migration Status	Pending migrations before deploy
Scheduler Cron	Scheduled work with no cron wiring
(+ 19 more)	Environment, security, performance, infrastructure

See docs/CHECKS.md for the full catalog.

Run in CI

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

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

Configuration

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

php artisan vendor:publish --tag=doctor

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 for examples.

Commands

Command	Description
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 only

License

MIT. See LICENSE.md.