flobbos/laravel-doctor

A small, shareable health report for Laravel applications.

v0.1.0 2026-07-16 21:23 UTC

Requires

• php: ^8.2
• illuminate/console: ^11.0|^12.0
• illuminate/contracts: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0

Requires (Dev)

• laravel/pint: ^1.18
• orchestra/testbench: ^9.0|^10.0
• pestphp/pest: ^3.0|^4.0
• pestphp/pest-plugin-laravel: ^3.0|^4.0

MIT

• health
• laravel
• diagnostics
• artisan

Published on Packagist.org on 2026-07-16 21:24 UTC

README

A small, zero-dependency health report for Laravel applications.

Laravel Doctor

  ✓ APP_DEBUG    Disabled.
  ✓ APP_ENV      Set to production.
  ✓ Queue        Using the redis connection.
  ✓ Cache        Using the redis store.
  ✓ Config cache Configuration is cached.
  ! Route cache  Routes are not cached.
  ✓ OPcache      Enabled.

  Score  93/100

Requirements

• PHP 8.2+
• Laravel 11 or 12

Installation

composer require flobbos/laravel-doctor --dev

Laravel discovers the service provider automatically. Run the report with:

php artisan doctor

Publish the configuration when you want to customize the checks:

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

Custom checks

Implement LaravelDoctor\Contracts\Check and add the class to config/doctor.php:

use LaravelDoctor\Contracts\Check;
use LaravelDoctor\ValueObjects\CheckResult;

final class DatabaseCheck implements Check
{
    public function run(): CheckResult
    {
        return CheckResult::pass('Database', 'Connection is healthy.');
    }
}

The container resolves every check, so constructor injection works as expected. Results can be pass, warning, or fail. Passes earn full score, warnings half score, and failures no score.

Development

composer install
composer test
composer format

License

MIT