PHP创建zip压缩文件时文件名后缀后出现随机字符如何解决？

问题诱发原因 #

带随机后缀的文件是ZipArchive生成的临时写入文件，正常流程下$zip->close()执行成功时，PHP会自动将临时文件重命名为指定的正式文件名并清理临时文件。该问题的核心诱因是ZipArchive::close()执行失败，常见触发场景如下：

• 目标目录../data/data/没有写入/修改权限，PHP无法完成临时文件到正式文件名的重命名操作
• 代码中使用的$overwrite变量未定义，导致传入ZipArchive::open()的第二个参数不符合预期，压缩包未被正常初始化
• 待添加的源文件./data/data.txt不存在或者无读取权限，导致文件写入压缩包流程中断，触发close操作异常
• 目标目录../data/data/本身不存在，ZipArchive无法在不存在的目录下创建正式压缩包文件
• 磁盘空间不足，无法完成压缩包的最终写入操作

修复方案 #

按以下步骤调整代码即可解决：

1. 明确定义$overwrite变量，避免未定义变量导致传入的打开参数异常，同时增加打开失败的错误提示：

// 根据业务需求明确定义是否覆盖已有文件
$overwrite = true;
if($zip->open($destination, $overwrite ? ZipArchive::OVERWRITE : ZipArchive::CREATE) !== true) {
    exit("压缩包初始化失败，请检查目标路径权限");
}

2. 提前校验目标目录是否存在、是否有写入权限，不存在则先递归创建：

$dir = '../data/data/';
// 目录不存在则递归创建，设置755权限
if (!is_dir($dir)) {
    mkdir($dir, 0755, true);
}
// 校验目录写入权限
if (!is_writable($dir)) {
    exit("目标目录无写入权限，请调整目录权限后重试");
}

3. 校验待压缩的源文件是否存在、可读：

$sourcePath = './data/data.txt';
if (!file_exists($sourcePath) || !is_readable($sourcePath)) {
    exit("待压缩的源文件不存在或无读取权限");
}
$zip->addFile($sourcePath, 'datafile.txt');

4. 增加close方法的返回值校验，及时捕获写入异常：

if (!$zip->close()) {
    exit("压缩包生成失败，请检查磁盘空间或路径权限");
}

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