PHP多文件下载问题：仅打包文件不含目录结构

我来帮你搞定这个问题！你遇到的核心问题是往Zip归档里添加文件时，没正确指定仅保留文件名作为压缩包内的路径，导致要么路径错误要么文件无法正常添加。下面是完整的解决方案和代码示例：

先直接上可运行的完整代码，再拆解关键细节：

<?php
// 替换成你要下载的文件路径数组（支持任意目录下的文件）
$targetFiles = [
    '/var/www/files/report_2024.pdf',
    '/home/user/photos/vacation.png',
    '/tmp/export_data.csv'
];

// 先检查Zip扩展是否启用
if (!extension_loaded('zip')) {
    die("请先启用PHP的Zip扩展才能生成压缩包");
}

$zipName = 'download_package.zip';
$zip = new ZipArchive();

// 创建临时Zip文件（用系统临时目录更安全，避免权限问题）
$tempZip = tempnam(sys_get_temp_dir(), 'user_download_');
if ($zip->open($tempZip, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== true) {
    die("无法创建临时压缩文件，请检查权限");
}

foreach ($targetFiles as $filePath) {
    // 先验证文件是否存在且可读，跳过无效文件
    if (!file_exists($filePath) || !is_readable($filePath)) {
        error_log("跳过不可访问的文件: {$filePath}");
        continue;
    }

    // 提取纯文件名，去掉所有目录层级
    $fileNameInZip = basename($filePath);
    
    // 核心：添加文件时指定Zip内的路径为纯文件名
    if (!$zip->addFile($filePath, $fileNameInZip)) {
        error_log("添加文件失败: {$filePath}");
    }
}

// 关闭Zip归档
$zip->close();

// 设置HTTP响应头，触发浏览器下载
header('Content-Type: application/zip');
header('Content-Disposition: attachment; filename="' . $zipName . '"');
header('Content-Length: ' . filesize($tempZip));

// 输出Zip文件内容
readfile($tempZip);

// 清理临时文件
unlink($tempZip);
exit;
?>

关键细节说明： #

• addFile()的第二个参数：这是你之前大概率踩坑的地方！默认只传文件路径的话，Zip会保留完整的目录结构；显式传入basename($filePath)，就能强制压缩包内只保留文件名，不带任何层级。
• 临时文件的使用：用tempnam()在系统临时目录创建Zip文件，比直接在Web目录下创建更安全，也能避免权限冲突。
• 文件有效性检查：提前验证文件是否存在、可读，避免单个无效文件导致整个下载流程失败。
• 处理同名文件：如果你的文件列表里有重名文件，后面的会覆盖前面的。可以加个小逻辑避免这种情况：

  $usedNames = [];
  foreach ($targetFiles as $idx => $filePath) {
      $baseName = basename($filePath);
      // 重名的话加序号前缀
      while (in_array($baseName, $usedNames)) {
          $baseName = "{$idx}_{$baseName}";
      }
      $usedNames[] = $baseName;
      $zip->addFile($filePath, $baseName);
  }
  

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