PHP实现数据备份_定时导出SQL文件到OSS【说明】-php教程-PHP中文网

php导出mysql失败主因是mysqldump路径不一致、字符集未设utf8mb4、cron环境变量缺失；须用which动态探测路径、强制--default-character-set=utf8mb4、crontab中写绝对路径并显式导出环境变量。

php实现数据备份_定时导出sql文件到oss【说明】

PHP脚本导出MySQL数据库时，mysqldump命令路径不一致导致失败

很多线上环境（尤其是Docker或CentOS 7+）的mysqldump不在/usr/bin/mysqldump，而是在/usr/local/mysql/bin/mysqldump或/opt/homebrew/bin/mysqldump（macOS M1/M2）。直接硬编码路径会执行失败，错误现象是生成空SQL文件或PHP报sh: mysqldump: command not found。

实操建议：

用which mysqldump在服务器上查真实路径，写进配置；

更稳妥的做法是在PHP中动态探测：

$dumpPath = shell_exec('which mysqldump 2>/dev/null');
$dumpPath = trim($dumpPath) ?: '/usr/bin/mysqldump';

执行前加判断：if (!is_executable($dumpPath)) { throw new RuntimeException("mysqldump not found or not executable"); }

导出SQL时中文乱码、表结构错乱或INSERT语句被截断

根本原因是mysqldump默认字符集不是UTF8MB4，尤其当数据库含emoji或四字节中文时，会丢数据或报错Incorrect string value。同时，某些版本mysqldump默认不加--skip-extended-insert，单条INSERT过长可能被OSS上传中断或MySQL导入时报max_allowed_packet超限。

实操建议：

强制指定字符集：--default-character-set=utf8mb4；
禁用扩展插入（每行一条INSERT），提升兼容性：--skip-extended-insert；
加上--single-transaction --routines --triggers --events确保一致性与完整性；

完整命令示例：

$cmd = sprintf(
    '%s --host=%s --user=%s --password=%s --default-character-set=utf8mb4 --single-transaction --routines --triggers --events --skip-extended-insert %s > %s',
    $dumpPath,
    escapeshellarg($host),
    escapeshellarg($user),
    escapeshellarg($pass),
    escapeshellarg($dbname),
    escapeshellarg($sqlFile)
);

用Aliyun OSS SDK上传大SQL文件时内存溢出或超时

一个500MB的SQL文件，如果用OssClient::putObject()直接读入内存再上传，PHP会OOM；且默认timeout只有60秒，上传必然失败。OSS官方推荐流式分块上传，但SDK v2.x不支持直接传文件句柄，v3.x才原生支持PutObjectRequest的body参数接受resource。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

实操建议：

确认SDK版本：用composer show aliyuncs/oss-sdk-php，优先升级到^3.0；
v3上传必须用fopen($sqlFile, 'rb')传资源流，不能用file_get_contents()；

设置客户端超时：

$ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint, [
    'connect_timeout' => 300,
    'timeout'         => 1800,
]);

上传后立即unlink($sqlFile)，避免磁盘占满；

cron定时执行PHP备份脚本时权限、路径、环境变量全不对

Web下能跑的脚本，放进crontab -e就失败：找不到mysqldump、连不上数据库（因为没读取~/.my.cnf）、OSS凭证加载失败（$_ENV为空）、相对路径./backup/变成/root/backup/。这不是代码问题，是执行上下文切换导致的。

实操建议：

crontab里写绝对路径：0 2 * * * /usr/bin/php /var/www/backup/dump-to-oss.php >> /var/log/backup.log 2>&1；
脚本开头加chdir(__DIR__);固定工作目录；
数据库密码别依赖~/.my.cnf，改用显式--password=xxx（注意安全，确保脚本权限为600）；

OSS凭证统一从$_SERVER['ALIYUN_OSS_ACCESS_KEY_ID']读，然后在crontab里export：

0 2 * * * export ALIYUN_OSS_ACCESS_KEY_ID="xxx"; export ALIYUN_OSS_ACCESS_KEY_SECRET="yyy"; /usr/bin/php /path/to/script.php

真正卡住人的从来不是“怎么连OSS”，而是mysqldump路径、字符集、cron环境这三处细节——它们不出错时一切顺利，一出错就是静默失败或数据损坏，很难定位。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！