使用mysqldump导出MySQL数据库遇未捕获错误及空SQL文件问题

问题根源分析 #

你遇到的Uncaught Error: Call to undefined function close()是个典型的小失误——PHP里根本没有全局的close()函数，正确关闭文件句柄的函数是fclose()。这个致命错误直接让脚本在第15行就中断了，后面的mysqldump备份命令压根没机会执行，所以生成的mydata.sql才会是空文件。

另外在XAMPP的Windows环境下，还有个容易踩的坑：系统默认PATH通常不包含MySQL的bin目录，直接调用mysqldump会找不到命令，就算前面的错误修复了，备份还是会失败。

修复后的完整代码 #

<?php
$filename = 'database/mydata.sql';
$database = 'stock';
$user = 'root';
$password = '';
$host = 'localhost';

/**
 * DO NOT EDIT BELOW THIS LINE (除了指定mysqldump路径)
 */
// 1. 修复文件关闭函数：用fclose替代错误的close
$fp = @fopen($filename, 'w+');
if (!$fp) {
    echo '无法创建 <b>'. $filename .'</b>，请手动创建该文件并设置权限为 <b>777</b>';
    exit;
}
fclose($fp); // 这里是解决致命错误的核心修改

// 2. 针对XAMPP Windows环境，指定mysqldump的完整路径
$mysqldumpPath = 'C:\xampp\mysql\bin\mysqldump.exe';
// 优化密码处理：空密码时避免生成无效的-p空格
$command = $mysqldumpPath . ' --opt -h '. $host .' -u '. $user .' '. (empty($password) ? '' : '-p'. $password) .' '. $database .' > '. $filename;

exec($command, $output = array(), $worked);

switch ($worked) {
    case 0:
        echo '数据库 <b>'. $database .'</b> 已成功导出到 <b>'. $filename .'</b>';
        break;
    case 1:
        echo '导出数据库 <b>'. $database .'</b> 到 <b>'. $filename .'</b> 时出现警告';
        break;
    case 2:
        echo '导出过程中发生错误，请确保备份文件路径正确并检查以下配置：' .
             '<br/><br/><table>' .
             '<tr><td>MySQL数据库名:</td><td><b>'. $database .'</b></td></tr>' .
             '<tr><td>MySQL用户名:</td><td><b>'. $user .'</b></td></tr>' .
             '<tr><td>MySQL密码:</td><td><b>NOTSHOWN</b></td></tr>' .
             '<tr><td>MySQL主机:</td><td><b>'. $host .'</b></td></tr>' .
             '<tr><td>备份文件名:</td><td><b>'. $filename .'</b></td>' .
             '</tr></table>' ;
        break;
}
?>

关键修改说明 #

• 替换close()为fclose()：这是解决当前致命错误的核心，PHP中操作文件句柄的关闭函数必须是fclose()，要传入之前用fopen()打开的文件指针。
• 指定mysqldump完整路径：Windows下XAMPP的mysqldump.exe默认在C:\xampp\mysql\bin\目录，系统PATH没包含的话，直接调用会找不到命令。
• 优化空密码处理：避免生成-p后面带空格的无效命令（MySQL会把空格当作密码的一部分，导致认证失败）。

额外排查建议 #

• 检查database目录的写入权限，确保脚本能生成备份文件。
• 可以在exec()前加echo $command; exit;，把实际执行的命令打印出来，手动在CMD里运行，确认命令本身是否能正常生成备份。
• 如果MySQL密码包含特殊字符（比如空格、&、*），需要用引号包裹密码，避免命令解析出错。

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