ThinkPHP 5 引入 PHPExcel/PhpSpreadsheet 导出 Excel 完整教程-ThinkPHP-PHP中文网

thinkphp 5 默认不支持 phpspreadsheet 是因自动加载机制未识别 psr-4 命名空间，需在 common.php 中用 loader::addnamespace() 注册 'phpoffice' 命名空间指向 src/ 目录，导出时须清理缓冲、设置正确响应头。

thinkphp 5 引入 phpexcel/phpspreadsheet 导出 excel 完整教程

ThinkPHP 5 默认不支持 PhpSpreadsheet，直接 composer require phpoffice/phpspreadsheet 后调用会报类找不到或自动加载失败——根本原因是 TP5 的自动加载机制未识别 PSR-4 命名空间。

为什么 new \PhpOffice\PhpSpreadsheet\Spreadsheet() 报错 Class not found

TP5.0/5.1 使用自己的 Loader 类处理类加载，而 phpoffice/phpspreadsheet 是标准 PSR-4 结构，其命名空间 PhpOffice\PhpSpreadsheet 不在 TP5 默认的加载映射里。Composer 安装后文件虽在 vendor/ 下，但 TP5 不会主动扫描该目录下的 PSR-4 命名空间。

不是 Composer 没装好，vendor/autoload.php 确实存在且可手动引入
不是路径写错，use PhpOffice\PhpSpreadsheet\Spreadsheet; 在 TP5 控制器里直接写会解析失败
TP5.0 的 Loader::addNamespace() 只支持扁平化命名空间（如 Org\Util），不支持多级反斜杠嵌套

正确引入 PhpSpreadsheet 的两种方式（推荐后者）

方式一：在控制器顶部手动引入 Composer 自动加载器（简单但不优雅）

// 在控制器方法开头或构造函数中
require_once VENDOR_PATH . 'autoload.php';

方式二：在 application/common.php 中注册 PSR-4 命名空间（推荐，一次配置全局生效）

excel-clean

Excel 数据清洗——去重、填补缺失值、格式转换。

下载

// application/common.php 最底部追加
if (function_exists('think\Loader::addNamespace')) {
    think\Loader::addNamespace('PhpOffice', VENDOR_PATH . 'phpoffice/phpspreadsheet/src/');
}

注意路径必须指向 src/ 目录，不是 vendor/phpoffice/phpspreadsheet/ 根目录
VENDOR_PATH 是 TP5 内置常量，等价于 ROOT_PATH . 'vendor/'
注册后即可正常使用 use PhpOffice\PhpSpreadsheet\Spreadsheet;

导出 Excel 时中文乱码、样式丢失、内存溢出的常见原因

TP5 默认输出响应头是 text/html，而 Excel 导出必须强制设置为 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，否则浏览器会尝试渲染为 HTML 或下载后打不开。

漏设 Content-Type 和 Content-Disposition 头，导致文件被当成网页打开或下载后损坏
用 $writer->save('php://output') 但没关掉 TP5 的模板输出缓冲（ob_end_clean() 必须调用）
大数据量导出未启用 MemoryCache 或分批写入，触发 PHP 内存限制（默认 128M 不够）
中文标题用 $sheet->setCellValue('A1', '姓名') 没问题，但若用 setCellValueByColumnAndRow() 传参顺序写反，列行颠倒会导致写到错误单元格

一个最小可用导出示例（含 HTTP 头 + 缓冲清理）

以下代码可直接放在 TP5 控制器方法中运行：

use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;

public function export()
{
    $spreadsheet = new Spreadsheet();
    $sheet = $spreadsheet->getActiveSheet();
    $sheet->setCellValue('A1', 'ID')->setCellValue('B1', '姓名')->setCellValue('C1', '时间');

    $data = [['1', '张三', date('Y-m-d H:i:s')], ['2', '李四', date('Y-m-d H:i:s')]];
    $row = 2;
    foreach ($data as $item) {
        $sheet->fromArray($item, null, 'A' . $row);
        $row++;
    }

    ob_end_clean(); // 关键：清空输出缓冲，避免 header 冲突
    header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
    header('Content-Disposition: attachment;filename="user_export_' . date('YmdHis') . '.xlsx"');
    header('Cache-Control: max-age=0');

    $writer = new Xlsx($spreadsheet);
    $writer->save('php://output');
}

如果项目已启用 debug 模式，TP5 日志可能提前输出了 warning，导致 header 发送失败——此时需确保导出逻辑前无任何 echo/print/debug 输出。