需检查PHP配置启用exec、设置Web用户权限、过滤路径并转义命令、校验备份文件完整性、记录日志并用crontab定时执行CLI脚本。
如果您需要在Linux服务器上通过PHP脚本自动执行文件备份任务，但发现exec函数调用失败或备份未按预期生成，则可能是由于PHP配置限制、权限不足或命令语法错误导致。以下是实现该功能的具体步骤：
一、确认PHP环境支持exec并启用相关配置
PHP默认可能禁用exec等系统调用函数，需检查php.ini中是否移除了exec在disable_functions列表中，并确保安全模式未启用。同时需验证Web服务器用户（如www-data或nginx）具备执行shell命令的权限。
1、使用phpinfo()函数查看当前PHP配置页面，搜索disable_functions项。
2、编辑php.ini文件，定位到disable_functions行，删除其中的exec（如有），保存后重启Web服务。
立即学习“PHP免费学习笔记（深入）”；
3、在PHP脚本中执行echo exec('whoami');，确认输出为Web服务器运行用户而非root。
二、编写基础备份脚本并设置目标路径权限
备份脚本需明确源目录、目标压缩路径及时间戳命名规则；目标备份目录必须对Web服务器用户具有写入权限，否则tar命令将因权限拒绝而静默失败。
1、创建备份存放目录：mkdir -p /var/www/backup。
2、修改目录属主：chown www-data:www-data /var/www/backup（根据实际Web用户调整）。
3、在PHP脚本中定义变量：$source = '/var/www/html'; $target_dir = '/var/www/backup'; $timestamp = date('Ymd_His'); $archive = "$target_dir/backup_{$timestamp}.tar.gz";。
三、构造安全可控的exec命令字符串
直接拼接用户输入可能导致命令注入，因此必须对路径参数进行严格过滤，仅允许字母、数字、下划线、斜杠和点号，并使用escapeshellarg确保字符串被正确转义。
1、过滤源路径：$safe_source = preg_replace('/[^a-zA-Z0-9_\/\.]/', '', $source);。
2、构建命令：$cmd = "tar -czf " . escapeshellarg($archive) . " -C " . escapeshellarg(dirname($safe_source)) . " " . escapeshellarg(basename($safe_source));。
3、执行并捕获输出：$output = []; $return_code = 0; exec($cmd . " 2>&1", $output, $return_code);。
四、添加执行结果校验与日志记录机制
仅依赖exec返回码不足以判断备份完整性，需进一步验证归档文件是否存在、大小是否非零，并将操作结果写入独立日志便于排查。
1、检查归档文件：if (file_exists($archive) && filesize($archive) > 0) { /* 成功 */ } else { /* 失败处理 */ }。
2、写入日志：$log_entry = date('Y-m-d H:i:s') . " - Backup " . ($return_code === 0 ? "SUCCESS" : "FAILED") . " - {$archive}\n"; file_put_contents('/var/www/backup/backup.log', $log_entry, FILE_APPEND | LOCK_EX);。
3、限制日志大小，保留最近100行：$lines = file('/var/www/backup/backup.log'); if (count($lines) > 100) { file_put_contents('/var/www/backup/backup.log', array_slice($lines, -100)); }。
五、配置定时任务触发PHP脚本执行
避免通过Web访问触发备份（存在并发与超时风险），应使用系统级crontab以指定用户身份定期运行CLI模式PHP脚本。
1、创建可执行脚本文件：/usr/local/bin/backup_runner.php，首行添加#!/usr/bin/env php，并赋予执行权限：chmod +x /usr/local/bin/backup_runner.php。
2、编辑crontab：sudo -u www-data crontab -e，添加行：0 2 * * * /usr/local/bin/backup_runner.php（每日凌晨2点执行）。
3、验证cron环境变量与手动执行一致，必要时在crontab中显式声明PATH：PATH=/usr/local/bin:/usr/bin:/bin。
