PHP ZipArchive生成的ZIP下载后显示为空但实际非空问题求助

Hey, let's break down this odd issue you're dealing with: your ZIP file downloads without errors, but when you open it directly in Windows File Explorer, it says "this folder is empty"—yet extracting it works perfectly. I’ve encountered this exact scenario before, so here’s what’s happening and how to fix it:

核心问题：addFile的路径参数使用不当 #

Your current code uses $zip->addFile($pdfFilePath); which only passes the full server path to the PDF. What this does is add the file to the ZIP using its complete absolute directory structure from your server (like C:\your-server-path\public\order_123.pdf).

Windows File Explorer can’t parse this nested system path when you open the ZIP directly, so it shows the root as empty. But unzipping tools (like WinRAR or 7-Zip) will extract the full directory tree, which is why you can see the file after extracting.

快速验证方式 #

If you open the ZIP with a third-party tool like 7-Zip, you’ll see the PDF is buried inside a chain of folders matching your server’s file path—instead of sitting right in the ZIP’s root directory.

修复代码 #

Update the addFile call to include a second parameter: the name you want the file to have inside the ZIP (just the filename, no path). Use basename() to pull the pure filename from your path:

$zip = new ZipArchive();
if ($zip->open('order_sheets.zip', ZipArchive::CREATE) === TRUE){
    // 第二个参数指定压缩包内的文件名，放在根目录
    $zip->addFile($pdfFilePath, basename($pdfFilePath));
    $zip->close(); // 将close移到if块内，避免打开失败时执行
} else {
    die("Failed to create ZIP archive");
}

$file_url = 'order_sheets.zip';
header('Content-Type: application/zip');
header('Content-disposition: attachment; filename='.$file_url);
header('Content-Length: ' . filesize($file_url));
readfile($file_url);
// 加上exit防止后续输出污染ZIP文件
exit;

额外优化提示 #

• Always add exit; or die(); after readfile()—this prevents any extra output (like leftover HTML from your page) from being appended to the ZIP file, which could cause corruption later.
• Move the $zip->close(); call inside the if block so you don’t try to close an unopened ZIP archive if the open() call fails.

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