php 无法在单次 http 请求中输出多个文件下载响应；正确做法是将每个表生成的 excel 内容写入临时文件，再统一压缩为 zip 包供用户下载。
php 无法在单次 http 请求中输出多个文件下载响应；正确做法是将每个表生成的 excel 内容写入临时文件，再统一压缩为 zip 包供用户下载。
在 Web 开发中，一个常见的需求是将数据库中所有表分别导出为 Excel 文件（如 .xls 格式）。但许多开发者会误以为只需在循环中多次调用 header('Content-Disposition: attachment; ...') 即可触发多个下载——这是不可行的。HTTP 协议规定：一次响应只能对应一个资源主体（body），多次设置 Content-Disposition 头会导致浏览器解析混乱，最终生成损坏、无法打开的文件（尤其在 Excel 中表现明显）。
✅ 正确解决方案：ZIP 打包分发
核心思路是：
- 遍历每张表，生成符合 Excel XML（SSML）格式的字符串内容；
- 将每份内容写入临时 .xls 文件（注意：此处使用的是简化版 Excel XML 格式，兼容 Excel 2003+，非 .xlsx）；
- 使用 ZipArchive 将所有 .xls 文件打包为一个 ZIP 压缩包；
- 设置正确的 HTTP 头，输出 ZIP 流并清空缓冲区，确保下载可靠。
以下是完整、健壮的实现示例（已优化安全性与可读性）：
<?php
// 确保 PDO 实例 $pdo 已正确初始化
$zip = new ZipArchive();
$zipName = 'database_tables_export_' . date('Y-m-d_H-i-s') . '.zip';
if ($zip->open($zipName, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== TRUE) {
die("无法创建 ZIP 文件");
}
try {
foreach ($pdo->query("SHOW TABLES") as $row) {
$table = $row[0];
$stmt = $pdo->prepare("SELECT * FROM `$table`");
$stmt->execute();
// 构建表头行
$fieldCount = $stmt->columnCount();
$colTitle = '<Row>';
for ($i = 0; $i < $fieldCount; $i++) {
$meta = $stmt->getColumnMeta($i);
$columnName = htmlspecialchars($meta['name'] ?? '', ENT_XML1, 'UTF-8');
$colTitle .= '<Cell ss:StyleID="2"><Data ss:Type="String">' . $columnName . '</Data></Cell>';
}
$colTitle .= '</Row>';
// 构建数据行
$dataRows = '';
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
$line = '<Row>';
foreach ($row as $value) {
$value = is_null($value) || $value === ''
? ''
: htmlspecialchars((string)$value, ENT_XML1, 'UTF-8');
$line .= '<Cell ss:StyleID="1"><Data ss:Type="String">' . $value . '</Data></Cell>';
}
$line .= '</Row>';
$dataRows .= $line . "\n";
}
// 组装完整 Excel XML 内容（最小化 SSML 模板）
$excelContent = <<<XML
<?xml version="1.0"?>
<Workbook xmlns="urn:schemas-microsoft-com:office:spreadsheet"
xmlns:o="urn:schemas-microsoft-com:office:office"
xmlns:x="urn:schemas-microsoft-com:office:excel"
xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet">
<DocumentProperties xmlns="urn:schemas-microsoft-com:office:office">
<Created>{date('c')}</Created>
</DocumentProperties>
<Styles>
<Style ss:ID="1"/>
<Style ss:ID="2"><Font ss:Bold="1"/></Style>
</Styles>
<Worksheet ss:Name="{$table}">
<Table>
{$colTitle}
{$dataRows}
</Table>
</Worksheet>
</Workbook>
XML;
// 写入临时文件并加入 ZIP
$fileName = $table . '.xls';
file_put_contents($fileName, $excelContent);
$zip->addFile($fileName, $fileName); // 第二个参数为 ZIP 内路径名，避免绝对路径风险
unlink($fileName); // 立即清理临时文件
}
$zip->close();
// 输出 ZIP 响应
header('Content-Type: application/zip');
header('Content-Disposition: attachment; filename="' . basename($zipName) . '"');
header('Content-Length: ' . filesize($zipName));
header('Pragma: no-cache');
header('Expires: 0');
ob_end_clean(); // 清除可能存在的输出缓冲
readfile($zipName);
unlink($zipName); // 下载后删除 ZIP 临时文件
exit;
} catch (Exception $e) {
unlink($zipName);
http_response_code(500);
echo "导出失败：" . htmlspecialchars($e->getMessage());
}⚠️ 关键注意事项
- SQL 注入防护：示例中已对 $table 名使用反引号包裹（SELECT * FROM \$table`），并依赖SHOW TABLES的可信上下文；若表名来自用户输入，请务必白名单校验或使用PDO::quote()` + 正则过滤。
- 内存与大表处理：本方案将整张表内容加载进内存生成 XML 字符串。若单表数据量极大（>10 万行），建议改用流式写入 ZIP 或切换至 phpspreadsheet 库配合临时磁盘缓存。
- 编码与特殊字符：使用 htmlspecialchars(..., ENT_XML1) 确保 XML 合法性，避免 <, &, " 等破坏结构。
- 浏览器兼容性：生成的 .xls 是 Excel 2003 XML 格式，现代 Excel、WPS、LibreOffice 均可正常打开；如需 .xlsx，推荐使用 PhpSpreadsheet 替代手动拼接。
通过 ZIP 打包方式，既规避了 HTTP 协议限制，又为用户提供了一键获取全部表格的清晰体验——这才是生产环境中推荐的标准实践。
立即学习“PHP免费学习笔记（深入）”；
