spatie/laravel-backup是laravel生产环境最成熟自动备份方案,支持数据库+文件双备份、gzip压缩、多磁盘存储及智能清理;需安装包与guzzle依赖,发布配置后启用压缩、设置绝对路径临时目录,并通过laravel调度器每日执行backup:clean与backup:run。

保障Laravel生产环境数据不因误操作、磁盘故障或攻击而永久丢失,必须建立可验证、可恢复、自动执行的备份机制。不能依赖人工临时导出,也不能把备份文件存在Web可访问路径下。
用spatie/laravel-backup实现全自动备份
这是目前Laravel生态中最成熟、最可控的本地化备份方案,支持数据库+文件双备份、自动清理、压缩与多目标存储,且完全走Laravel调度体系,避免crontab环境错乱问题。
第一步:安装扩展包并补全依赖
运行composer require spatie/laravel-backup;若使用Laravel 10+,还需执行composer require guzzlehttp/guzzle,否则backup:run会报Class "GuzzleHttp\Client" not found。
第二步:发布配置并校验磁盘路径
执行php artisan vendor:publish --provider="Spatie\Backup\BackupServiceProvider"生成config/backup.php;打开该文件,确认'destination' => ['disks' => ['local']],再检查config/filesystems.php中local驱动的root值是否为绝对路径(如/var/www/html/storage/app),【绝对禁止设为/var/www/html/public或任何Web根目录子路径】。
第三步:启用gzip压缩并设置临时目录
在config/backup.php中将'database_dump_compressor' => null改为'database_dump_compressor' => Spatie\DbDumper\Compressors\GzipCompressor::class;同时确认'temporary_directory' => storage_path('app/backup-temp')指向的目录存在且有写权限——这个目录空间不足会导致dump静默失败,只留下空.sql.gz文件。
第四步:配置每日自动调度
编辑app/Console/Kernel.php,在schedule()方法中添加:$schedule->command('backup:clean')->daily()->at('01:00');$schedule->command('backup:run')->daily()->at('02:00');
然后确保服务器crontab已配置* * * * * cd /var/www/html && /usr/bin/php artisan schedule:run >> /dev/null 2>&1,注意必须用绝对路径调用PHP二进制文件。
仅备份数据库的轻量级Artisan命令方案
适用于资源受限、只需保障核心数据、或暂未引入第三方包的项目。全程不依赖外部PHP类库,仅调用系统mysqldump。
方法一:手写BackupDatabaseCommand
执行php artisan make:command BackupDatabaseCommand创建命令类;在handle()中拼接shell_exec命令:shell_exec("mysqldump -u{$this->dbUser} -p{$this->dbPass} {$this->dbName} --default-character-set=utf8mb4 > {$backupPath}");
务必显式指定--default-character-set=utf8mb4,否则恢复时可能报Unknown character set错误。
方法二:直接复用.env配置
改用env()读取DB_*变量,避免硬编码凭据;备份路径建议用storage_path("app/backups/db_".date('Y-m-d_H-i-s').".sql"),这样文件自然落入Laravel Storage管理范围,后续可统一做权限隔离。
这一步操作起来很简单,直接把文件拖进去就行。但要注意:执行前必须确保storage/app/backups目录存在且www-data用户有写权限,运行chmod -R 755 storage/app/backups即可。
关键缓存项的JSON快照备份
当Redis宕机或执行flushall后,权限菜单、站点配置等关键缓存项无法自动重建,此时需从持久化快照恢复。
创建ExportCacheSnapshot命令:php artisan make:command ExportCacheSnapshot;在handle()中定义需快照的键名数组,例如['site_config', 'user_permissions', 'tenant_settings'];逐个调用Cache::get($key)并用json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT)序列化。
保存路径设为storage_path("app/cache_snapshots/snapshot_".now()->format('Y-m-d_H-i-s').".json");注意不要用Storage::disk('public'),防止快照文件被外部直接访问。
最后在Kernel.php中加入定时任务:$schedule->command('cache:export')->dailyAt('03:00')。这一步不需要额外安装扩展,Laravel原生Cache门面即可支撑。











