Yii框架Excel怎么导出_Yii框架PhpSpreadsheet使用详解【操作】-php教程-PHP中文网

直接用PhpSpreadsheet导出需确保四点：正确自动加载（引入vendor/autoload.php）、设置响应头（Content-Type/Disposition等）、清空输出缓冲（ob_end_clean()）、合理控制内存（避免逐单元格写入、启用缓存或分批处理）。

yii框架excel怎么导出_yii框架phpspreadsheet使用详解【操作】

直接用 PhpOffice\PhpSpreadsheet\IOFactory::load() 或 new Spreadsheet() 就能导出，但不处理自动加载、响应头、内存和缓冲区，90% 的“空白文件”“Class not found”“乱码下载”都源于这四点。

Class not found 错误：Yii2 没注册 PhpSpreadsheet 的 PSR-4 自动加载

Composer 安装完 phpoffice/phpspreadsheet 后，类文件确实在 vendor/phpoffice/phpspreadsheet/src，但 Yii2 默认只加载自己命名空间（app\、yii\）和 Composer 的 autoload_psr4.php —— 而 PhpSpreadsheet 的根命名空间是 PhpOffice，没被映射到路径，所以 new \PhpOffice\PhpSpreadsheet\Spreadsheet() 仍报错。

实操建议：

确认 vendor/autoload.php 已在 web/index.php 中引入（标准 Yii2 模板默认已做，但自定义入口或 console 脚本容易漏）
不要手动 require 任何 .php 文件，硬引会破坏命名空间解析
如使用老版本 Yii2（aliases，需显式添加：
'@PhpOffice' => '@vendor/phpoffice/phpspreadsheet/src' 到 config/web.php 的 aliases 数组中

导出后浏览器打开失败或乱码：响应头缺失或顺序错误

Yii2 不会自动设置 Excel 下载所需的 Content-Type 和 Content-Disposition，漏设或晚于输出内容发送，就会导致文件损坏、被当网页渲染、或下载后打不开。

实操建议：

必须在调用 $writer->save('php://output') 前，手动设置响应头
务必先执行 ob_end_clean() 清空已有输出缓冲——Yii2 Debug Toolbar、日志、甚至 PHP 文件末尾的空格都可能提前触发 headers 已发送
典型响应头组合：
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment; filename="data.xlsx"');
header('Cache-Control: max-age=0');

大数据导出内存溢出或超时：默认全量加载进内存

Spreadsheet 对象默认把所有单元格缓存在 PHP 内存里，10 万行 × 50 列就很容易突破 512MB 限制，报 Fatal error: Allowed memory size exhausted 或生成空白文件。

Excel 打印区外内容清理

一键清除Excel打印区域外的残留内容，打印区内所见即所得。方便提交给客户，实现打印区外内容保密的目的。适用场景：给客户提交报价、计算书等。

下载

实操建议：

避免用 getActiveSheet()->setCellValue() 在循环中逐单元格写入——改用 $worksheet->fromArray($data) 批量导入二维数组，性能高 10 倍以上
大数据场景优先写入临时文件：
$writer->save('/tmp/export_' . time() . '.xlsx');
再用 Yii::$app->response->sendFile() 推送，绕过内存瓶颈
如必须流式输出，启用缓存策略：
\PhpOffice\PhpSpreadsheet\Settings::setCacheStorageMethod(\PhpOffice\PhpSpreadsheet\Settings::CACHE_TO_PHP_TMP);

读取 Excel 报 “Invalid file format” 或跳过部分 sheet：未正确识别格式或未指定工作表

IOFactory::load() 依赖文件扩展名和魔数判断格式，若文件后缀是 .xls 但实际是 xlsx 内容（或反之），或文件被其他程序静默修改过，就会报错；另外新版 PhpSpreadsheet 不再自动激活第一个 sheet，getActiveSheet() 可能返回 null。

实操建议：

读取前先用 IOFactory::identify($filePath) 确认真实格式，再显式调用对应 Reader，例如：
$reader = IOFactory::createReader('Xlsx');
别假设只有一页表，显式获取目标 sheet：
$spreadsheet->getSheet(0) 或 $spreadsheet->getSheetByName('Sheet1')
读取时加 $reader->setReadDataOnly(true) 跳过样式/公式，提速且降低出错概率

最易被忽略的是 ob_end_clean() —— 它不是可选项，而是导出链上不可跳过的一步。哪怕只是多了一个空格、一段调试 var_dump 或一个未关闭的 ob_start()，都会让 header 失效，最终用户收到一个“能下载但打不开”的文件。