Download the PHP package fomvasss/laravel-backup-ui without Composer
On this page you can find all versions of the php package fomvasss/laravel-backup-ui. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download fomvasss/laravel-backup-ui
More information about fomvasss/laravel-backup-ui
Files in fomvasss/laravel-backup-ui
Package laravel-backup-ui
Short Description Web interface for spatie/laravel-backup package
License MIT
Informations about the package laravel-backup-ui
Laravel Backup UI
Support
If this package is useful to you, consider supporting its development:
USDT TRC20 address:
THLgp6DxiAtbNHvgnKV56vk1L38UuUagKf
A beautiful web interface for managing spatie/laravel-backup package. Built with Bootstrap 5 and designed to be easily integrated into any Laravel admin panel.
Features
- ๐จ Modern Bootstrap 5 UI
- ๐ Backup status monitoring
- ๐ Create backups (full, database-only, files-only)
- โก Asynchronous backup creation via queues (NEW!)
- ๐ Real-time progress tracking with Ajax polling
- ๐ฅ Download backup files
- ๐๏ธ Delete individual backups
- ๐งน Clean old backups
- ๐ Flexible authentication system
- ๐ฑ Responsive design
- ๐ฏ Laravel Horizon support
Screenshots
Requirements
- PHP ^8.0
- Laravel ^9.0|^10.0|^11.0|^12.0
- spatie/laravel-backup ^8.0|^9.0
Version Compatibility
This package supports both major versions of spatie/laravel-backup and multiple Laravel versions:
- spatie/laravel-backup v8.x: Full compatibility with existing API
- spatie/laravel-backup v9.x: Automatic adaptation to new API structure
- Laravel 9.x, 10.x, 11.x, 12.x: Full framework compatibility
The package automatically detects the installed version and adapts accordingly:
- Command signatures are handled for both versions
- API changes in BackupDestinationStatusFactory are automatically managed
- Storage calculation methods work with both versions
- Error handling is improved for both versions
For detailed Laravel v12 compatibility information, see LARAVEL-V12-COMPATIBILITY.md.
Installation
You can install the package via composer:
Publish the configuration file:
Optionally, you can publish the views:
Configuration
The configuration file config/backup-ui.php allows you to customize the package:
Queue Support (Async Backups)
For large databases or file backups that might timeout in a web request, you can enable asynchronous backup creation using Laravel queues:
Benefits:
- โ No timeouts for large backups
- โ Real-time progress tracking
- โ Works with Laravel Horizon
- โ Automatic retries on failure
Quick Start:
- Enable in config:
'queue' => ['enabled' => true, 'name' => 'backups'] - Start Horizon:
php artisan horizon - Create backup through UI
For detailed documentation, see QUEUE_SUPPORT.md.
Troubleshooting
"mysqldump: not found" Error
If you encounter the error sh: 1: mysqldump: not found when creating backups through the web interface, this is because the web server doesn't have the same PATH as your console.
Solutions:
-
Install MySQL client tools on your server:
- Set environment PATH in your web server configuration:
The mysqldump tool should be properly configured at the server level, not at the application level.
"Backup file not found" when downloading
If existing backups show in the list but fail to download with "Backup file not found", this is because spatie/laravel-backup stores files in date-organized subdirectories.
The package automatically handles this by:
- Searching for files in spatie's date-based directory structure (
backup-name/YYYY/MM/DD/file.zip) - Looking through all subdirectories for matching filenames
- Supporting files with special characters in names
For debugging, check Laravel logs for detailed file search information.
External Disk Support (S3, FTP, Google Cloud, etc.)
The package fully supports external backup disks including:
- Amazon S3 (
s3) - Google Cloud Storage (
gcs,google) - FTP/SFTP (
ftp,sftp) - Dropbox (
dropbox) - Other Laravel filesystem drivers
Key features for external disks:
- Automatic driver detection and optimization
- Intelligent reachability checking for each disk type
- Graceful handling of network timeouts and connection issues
- Proper streaming for large backup file downloads
- Error logging for troubleshooting remote disk issues
Configuration example for S3:
Configuration example for FTP:
Note: For external disks, file operations (download/delete) may take longer due to network latency. The interface will show appropriate loading states.
Usage
After installation, the backup interface will be available at /admin/backup (or your configured route prefix).
Basic Usage
- View Backups: Navigate to the backup UI to see all configured backup destinations and existing backups
- Create Backup: Use the "Create Backup" dropdown to create full, database-only, or files-only backups
- Download: Click the download button next to any backup to download it
- Delete: Click the trash icon to delete individual backups
- Clean: Use the "Clean Old" button to remove old backups according to your retention policy
Custom Authentication
You can implement custom authentication by setting the auth_callback in the configuration:
Restricting Access to Specific Users
Integration with Admin Panels
The package is designed to be easily integrated into existing admin panels:
Laravel Nova
Filament
Custom Admin Panel
Simply add a link to /admin/backup in your admin navigation menu.
Customization
Views
If you need to customize the views, publish them first:
The views will be published to resources/views/vendor/backup-ui/.
Styling
The package uses Bootstrap 5 classes. You can override styles by publishing the views and modifying the CSS, or by including your own CSS after the Bootstrap CSS.
Security
The package includes several security measures:
- Authentication middleware (configurable)
- User restriction capabilities
- CSRF protection on all forms
- File existence validation before downloads
- Path traversal protection
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
If you discover a security vulnerability within this package, please send an e-mail to the author via email. All security vulnerabilities will be promptly addressed.
Credits
- fomvasss
- Built on top of spatie/laravel-backup
License
The MIT License (MIT). Please see License File for more information.
Support
If you find this package helpful, please consider starring the repository and sharing it with others!
All versions of laravel-backup-ui with dependencies
laravel/framework Version ^9|^10|^11|^12|^13
spatie/laravel-backup Version ^8|^9