PHP备份脚本单次URL请求多次执行，大目录压缩遇难题

一、解决脚本重复执行生成不完整备份的问题 #

原因分析 #

每隔30秒生成不完整文件，核心原因是脚本执行超时中断后触发重复执行：

• 浏览器访问时，PHP默认执行时限多为30秒，1GB目录压缩耗时远超此限制，浏览器超时后会自动重试；
• CronJob若执行间隔设置过短，会在前一次压缩未完成时触发新进程；
• 缺少并发执行限制，多进程同时压缩会导致文件不完整。

解决办法 #

1. 添加文件锁，禁止并发执行
   在脚本开头加入锁机制，确保同一时间仅一个进程运行：

$lockFile = dirname(__FILE__) . '/backup.lock';
$lockHandle = fopen($lockFile, 'w');
// 非阻塞模式获取排他锁，失败则直接退出
if (!flock($lockHandle, LOCK_EX | LOCK_NB)) {
    exit('Backup is already running');
}

// 脚本结束后自动释放并删除锁文件
register_shutdown_function(function() use ($lockHandle, $lockFile) {
    flock($lockHandle, LOCK_UN);
    fclose($lockHandle);
    unlink($lockFile);
});

2. 延长PHP执行时限
   针对超时中断问题，在脚本开头调整执行时间与内存限制：

// 设置为0表示无时间限制，或根据实际需求设置具体秒数
set_time_limit(0);
// 按需调整内存限制，避免压缩时内存不足
ini_set('memory_limit', '2G');

3. 修正CronJob配置
   根据实际压缩耗时设置CronJob间隔，比如1GB目录压缩需10分钟，则将执行间隔设为15分钟以上，避免重复触发。

4. 避免通过浏览器执行备份
   浏览器的超时机制难以完全规避，建议仅通过CronJob或命令行执行脚本：

php /path/to/your/backup_script.php

二、大文件目录的替代压缩方案 #

PHP内置的ZipArchive、第三方Archive_Tar处理大文件易出现内存溢出或多磁盘异常，推荐以下稳定方案：

1. 调用系统Shell命令（最优方案） #

利用服务器自带的tar/zip命令，通过PHP执行系统命令，无需将文件加载到PHP内存，性能更稳定：

$dir = realpath(dirname(__FILE__).'/../../dir_to_zip/');
$archivname = dirname(__FILE__)."/backup_".basename($dir).date('_Y-m-d_His').".tar.gz";

// 使用tar命令压缩，escapeshellarg避免命令注入风险
$command = "tar -zcf " . escapeshellarg($archivname) . " " . escapeshellarg($dir);
exec($command, $output, $returnVar);

if ($returnVar === 0) {
    echo 'Backup completed successfully';
} else {
    echo 'Backup failed: ' . implode("\n", $output);
}

注：需确保服务器支持tar命令，且PHP的exec()函数未被禁用。

2. 使用PHP内置PharData扩展 #

PharData为PHP内置扩展，支持分块处理归档，无需额外安装：

set_time_limit(0);
$dir = realpath(dirname(__FILE__).'/../../dir_to_zip/');
$archivname = dirname(__FILE__)."/backup_".basename($dir).date('_Y-m-d_His').".tar.gz";

$phar = new PharData($archivname);
// 递归添加目录，自动分块处理避免内存溢出
$phar->buildFromDirectory($dir);
$phar->compress(Phar::GZ); // 压缩为gzip格式

echo 'done';

3. 拆分备份文件 #

若单个归档文件过大，可按目录或文件大小拆分备份，或仅备份增量内容（如最近修改的文件），降低单次压缩压力。

内容的提问来源于stack exchange，提问作者Chris