Download the PHP package webhubworks/laravel-backup-viewer without Composer
On this page you can find all versions of the php package webhubworks/laravel-backup-viewer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download webhubworks/laravel-backup-viewer
More information about webhubworks/laravel-backup-viewer
Files in webhubworks/laravel-backup-viewer
Package laravel-backup-viewer
Short Description A read-only admin page for spatie/laravel-backup: per-target file listings, health status, monitor results, scheduled commands, and notification routing.
License MIT
Homepage https://github.com/webhubworks/laravel-backup-viewer
Informations about the package laravel-backup-viewer
Laravel Backup Viewer
A read-only admin page for
spatie/laravel-backup. No interactive scheduling, no setting changes — just a clean view of the state your backup config produces.
Features
- Backup health — last run, last successful run, last monitor run, scheduled commands (with humanized cron timings)
- Per-target checks — one section per disk × backup-name; reachability, configured spatie checks, plus a synthetic free-disk-space check on local disks
- Backups by target — file table per disk, with size / created / download for local-disk backups, encryption-state badges, and a disk-usage bar
- Notifications — event → channel → recipient routing for every entry in
backup.notifications.notifications
Event-driven: the page reads from a small JSON state file populated by listeners that subscribe to spatie's BackupHasFailed, BackupWasSuccessful, HealthyBackupWasFound, UnhealthyBackupWasFound. No work runs on page load except free-disk-space probing.
Installation
Optionally publish the config (see Configuration for what's in it):
The package depends on spatie/laravel-backup to actually do anything useful — install it too if you haven't:
Authorization
The route is only accessible in the local environment by default. Open it up elsewhere with the gate-style API (same pattern as Horizon::auth):
The callback receives the incoming Illuminate\Http\Request and must return true to allow access.
Configuration
Default settings work for most apps. To override (route path, middleware, download size cap, favicon, low-disk threshold), publish the config:
That writes config/backup-viewer.php:
Multi-icon favicon setups
For apps that use realfavicongenerator-style multi-icon setups, paste the entire <link> block into the favicon.html key:
Where state is stored
Listeners write event activity to <first-local-backup-disk>/<backup-name>/laravel-backup-viewer-state.json so the file lives next to the backups it describes. Apps with only remote disks fall back to storage/app/backup-viewer/state.json. The file is written atomically (tmp + rename).
Scheduling
Stick the spatie commands in Laravel's scheduler:
The Backup health card surfaces those entries and humanizes the cron expression ("Daily at 02:00").
Commands you'll actually run
This package adds no Artisan commands of its own. The relevant ones come from spatie/laravel-backup:
| Command | Purpose |
|---|---|
php artisan backup:run |
Create a new backup |
php artisan backup:run --only-db |
Database-only backup |
php artisan backup:list |
List backups across all configured disks |
php artisan backup:clean |
Apply retention rules |
php artisan backup:monitor |
Re-run health checks; populates this page's monitor card |
Frontend
Pre-compiled Tailwind v4 + Alpine.js are committed inside the package and inlined into the response via BackupViewer::css() / BackupViewer::js() (same pattern as Laravel Horizon). The host app needs no Vite config, no vendor:publish step for assets.
Compatibility
- PHP 8.3+
- Laravel 11, 12, 13
- spatie/laravel-backup 9.x
License
MIT. See LICENSE.md.
All versions of laravel-backup-viewer with dependencies
illuminate/contracts Version ^11.0|^12.0|^13.0
spatie/laravel-package-tools Version ^1.16