illuma-law / healthcheck-storage

v0.1.5 2026-10-23 13:43 UTC

Requires

• php: ^8.3
• illuminate/contracts: ^12.0||^13.0
• illuminate/database: ^12.0||^13.0
• illuminate/support: ^12.0||^13.0
• spatie/laravel-health: ^1.39
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.14
• mrpunyapal/peststan: ^0.2.12
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^11.1.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• spatie/laravel-ray: ^1.35

MIT

• illuma-law

• storage
• health
• laravel
• illuma-law

Published on Packagist.org on 2026-10-23 13:43 UTC

README

A Spatie Laravel Health check that writes, reads, and deletes a small probe file on each configured Laravel disk.

Requirements

• PHP 8.3 or later
• Laravel 12 or 13
• Spatie Laravel Health 1.39 or later

Install

composer require illuma-law/healthcheck-storage

Register the check with your other health checks:

use IllumaLaw\HealthCheckStorage\StorageDiskWritabilityCheck;
use Spatie\Health\Facades\Health;

Health::checks([
    StorageDiskWritabilityCheck::new()->disks(['local', 'public']),
]);

By default, the check probes the local and public disks. Set HEALTH_STORAGE_DISKS=s3,archive or publish the package config to choose other disks:

php artisan vendor:publish --tag=healthcheck-storage-config

Each probe writes a small file, reads it back, and deletes it. A write, read, or cleanup error fails the check. Unknown disk names are skipped; if no configured disks can be probed, the result is skipped.

Test

composer test
composer analyse
vendor/bin/pint --test

MIT licensed. See LICENSE.md.