使用PhpSpreadsheet可解决PHP导出Excel的常见报错，需确保正确安装库、避免输出冲突、调整内存限制，并遵循命名空间和编码规范以保证导出成功。
PHP在导出数据到Excel时出现函数报错，通常与使用的扩展库、环境配置或代码逻辑有关。目前主流方式是使用 PhpSpreadsheet 替代已废弃的 PHPExcel。下面从常见错误入手，结合 PhpSpreadsheet 的正确使用方法进行说明。
一、常见报错原因分析
导出Excel时报错，多数情况由以下几点引起：- 类未找到（Class 'PHPExcel' not found）：项目中仍引用已被弃用的 PHPExcel，Composer 未安装 PhpSpreadsheet 或命名空间错误。
- 内存溢出（Allowed memory size exhausted）：处理大量数据时默认内存不足，需调整 php.ini 中 memory_limit。
- 输出前已有内容输出（Headers already sent）：在导出前有 echo、空格、BOM 头等提前输出内容，导致 header 无法设置。
- 文件路径不可写或不存在：保存文件时指定路径无权限或目录不存在。
- Composer 自动加载失败：未正确引入 vendor/autoload.php 或类名拼写错误。
二、使用 PhpSpreadsheet 正确导出 Excel
PhpSpreadsheet 是 PHPOffice 团队维护的现代库，支持 .xlsx 格式，功能强大且持续更新。1. 安装 PhpSpreadsheet
通过 Composer 安装（推荐）： composer require phpoffice/phpspreadsheet确保项目根目录存在 vendor/autoload.php 并正确引入。
2. 基础导出示例（浏览器下载）
立即学习“PHP免费学习笔记（深入）”；
```php require_once 'vendor/autoload.php';use PhpOffice\PhpSpreadsheet\Spreadsheet; use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
$spreadsheet = new Spreadsheet(); $sheet = $spreadsheet->getActiveSheet();
// 设置表头 $sheet->setCellValue('A1', '姓名'); $sheet->setCellValue('B1', '年龄'); $sheet->setCellValue('C1', '邮箱');
// 添加数据 $data = [ ['张三', 25, 'zhangsan@example.com'], ['李四', 30, 'lisi@example.com'], ['王五', 28, 'wangwu@example.com'] ];
$row = 2; foreach ($data as $item) { $sheet->setCellValue('A' . $row, $item[0]); $sheet->setCellValue('B' . $row, $item[1]); $sheet->setCellValue('C' . $row, $item[2]); $row++; }
// 设置下载响应头 header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'); header('Content-Disposition: attachment;filename="users.xlsx"'); header('Cache-Control: max-age=0');
$writer = new Xlsx($spreadsheet); $writer->save('php://output');
3. 避免“Headers already sent”错误
- 确保脚本开始无任何 echo、var_dump 输出。
- 检查文件是否含 BOM（建议用 UTF-8 without BOM 编码保存）。
- 避免 include/require 文件前后有空行或空白字符。
4. 处理大数据量导出
- 增加内存限制：
ini_set('memory_limit', '512M'); - 启用单元格缓存策略（如使用 MemoryGZip 或 DiskISAM）。
- 分批写入，避免一次性加载所有数据。
三、常见问题快速排查清单
- 确认已安装 PhpSpreadsheet：检查 vendor 目录是否存在 phpoffice/phpspreadsheet。
- 确认引入了 autoload.php。
- 检查命名空间是否正确（不是 PHPExcel）。
- 导出前不要有任何输出（包括空格、错误信息、HTML标签）。
- 测试服务器是否支持 zlib（Xlsx 需要压缩支持）。
- 查看 PHP 错误日志定位具体异常信息。
