PHP 打包 ZIP 怎么去掉服务器目录前缀

服务器上的文件通常长这样：/var/www/app/storage/reports/2026/summary.pdf。如果直接把这个绝对路径交给 ZipArchive::addFile()，ZIP 内部名称就可能带着不需要的目录层级。解决办法不是事后修改压缩包，而是在添加文件时显式传入第二个参数：把物理文件路径映射成 ZIP 内部的相对路径，例如 2026/summary.pdf。

先把物理路径和 ZIP 名称分开

$filepath 是 PHP 进程在服务器上读取的真实文件，$entryname 是用户解压时看到的 ZIP 内部名称。官方手册说明，只要第二个参数非空，它就会覆盖由物理路径推导出的本地名称。因此最小写法可以这样处理：

open($zipPath, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== true) {
    throw new RuntimeException('无法打开 ZIP 文件');
}

// 第一个参数读服务器文件，第二个参数只决定 ZIP 内部名称。
if (!$zip->addFile($source, '2026/summary.pdf')) {
    $zip->close(); // 失败时也释放已经打开的归档。
    throw new RuntimeException('文件加入 ZIP 失败');
}

if (!$zip->close()) {
    throw new RuntimeException('ZIP 写入失败');
}
?>

解压后看到的是 2026/summary.pdf，不会暴露 /var/www/app/storage/reports/。这里的第二个参数不是服务器上的新文件，也不会把源文件移动到别处；它只是归档条目的名字。

递归目录时用归档根目录计算相对名

多个文件不能简单地都使用 basename()，否则不同子目录里的同名文件会互相覆盖。更稳妥的方式是把一个目录指定为“归档根”，从每个文件路径中去掉这段前缀，保留其余目录结构。

isFile() || !$fileInfo->isReadable()) {
            continue; // 只把可读取的普通文件加入归档。
        }

        $absolute = $fileInfo->getPathname();
        $relative = substr($absolute, strlen($root) + 1);
        $entryname = str_replace(DIRECTORY_SEPARATOR, '/', $relative);

        // entryname 不含 root，且保留子目录，避免同名文件碰撞。
        if (!$zip->addFile($absolute, $entryname)) {
            throw new RuntimeException("加入文件失败：{$absolute}");
        }
        $count++;
    }

    return $count;
}
?>

例如根目录是 /srv/site/uploads，文件是 /srv/site/uploads/invoices/2026/a.pdf，最终 entryname 就是 invoices/2026/a.pdf。使用正斜杠可以减少不同操作系统解压工具对目录分隔符的差异。

创建 ZIP 时要把失败点留出来

打包流程至少有三个独立结果：归档文件能否打开、源文件能否加入、最终归档能否关闭写入。不要只看 addFile() 的返回值就认为下载包已经完成；最后的 close() 也应该检查。下面这张表适合放进日志或排障清单。

前缀还在时，优先检查这四处

第一，确认传给 addFile() 的第二个参数不是空字符串；空值时库会根据 filepath 处理名称。第二，不要用 basename() 替代相对路径，它会丢掉业务目录，也可能制造同名覆盖。第三，计算相对路径前先固定归档根目录，避免对不在根目录下的路径强行 substr()。第四，跨平台部署时把 entryname 统一为 /，并拒绝带有 ../ 的外部输入，防止归档内容逃出预期目录。

如果文章需要打包用户上传的文件，服务器真实路径应由服务端根据文件 ID 映射得到，不能直接信任请求中的路径。归档内部名称可以来自业务字段，但同样要做规范化和重名策略。这样既能隐藏服务器目录前缀，也不会把“改名”误当成“移动文件”。

常见问题

只想去掉第一层目录，应该用 basename() 吗？

不建议。若需要保留多级子目录，应以归档根目录计算相对路径；只有明确只收集单层文件且能接受同名覆盖时，才适合使用 basename。

为什么 ZIP 里出现反斜杠目录？

通常是把 Windows 路径分隔符原样当作 entryname 写入。生成内部名称时统一替换为正斜杠，兼容性更好。

addFile() 成功但最终 ZIP 还是打不开怎么办？

先检查每个源文件是否存在且可读，再检查最后的 close() 返回值和输出目录权限。不要在 close() 前删除或移动正在加入归档的源文件。