Yii框架导出CSV需用fputcsv+正确HTTP头，核心难点是避免前置输出导致乱码；必须清空缓冲、添加UTF-8 BOM、禁用调试条，并用each()分批处理防超时溢出。
Yii 框架导出 CSV 不需要第三方 Excel 库，原生 PHP 的 fputcsv + 正确的 HTTP 头就能稳定跑通，但最容易卡在「没下载、只刷出乱码」——根本原因几乎全是输出缓冲或编码问题。
导出前必须清空所有前置输出
只要 header() 调用前有任何 echo、var_dump、print_r、甚至空白行或 BOM 字符，浏览器就收不到文件下载指令，只会把 CSV 内容当 HTML 渲染成乱码。
- 确保控制器 action 里没有
echo/print等调试语句 - 检查视图文件（.php）开头不能有空格或 UTF-8 BOM
- 禁用 Yii 的调试工具条（
YII_DEBUG = false）或确认它没提前触发输出 - 如果用了
ob_start()，导出前必须ob_end_clean()，不能只ob_flush()
fputcsv 配合 php://output 是最轻量方案
不用临时文件、不占磁盘，适合中小数据量（万级以内）。关键点是流打开方式和编码转换：
- 用
$fp = fopen('php://output', 'w')直接写响应体 - 写入前先输出 UTF-8 BOM：
fwrite($fp, "\xEF\xBB\xBF")，否则 Excel 打开中文会乱码 - 每行数据必须是数组，
fputcsv($fp, $row)自动处理引号和逗号转义 - 数据含中文时，务必提前转 GBK 或保持 UTF-8 + BOM；Excel for Windows 默认认 GBK，Mac 认 UTF-8
示例片段：
Knowledge Graph - Csv Graph Loader Generator
下载
从 CSV 数据集生成图数据库加载器和三元组映射。将表格 CSV 数据转换为图数据库可直接使用的节点、边和三元组。
public function actionExport()
{
$filename = 'users_' . date('Ymd_His') . '.csv';
header('Content-Type: text/csv; charset=UTF-8');
header("Content-Disposition: attachment; filename={$filename}");
header('Cache-Control: must-revalidate');
$fp = fopen('php://output', 'w');
fwrite($fp, "\xEF\xBB\xBF"); // UTF-8 BOM
fputcsv($fp, ['ID', '姓名', '邮箱']);
foreach (User::find()->select(['id', 'name', 'email'])->asArray()->each(100) as $row) {
fputcsv($fp, $row);
}
fclose($fp);
}
大数据量导出要防内存溢出和超时
查几万行用 all() 会直接 OOM；用 each() 或 batch() 迭代，同时手动刷新输出缓冲：
- 用
->each(500)控制每次取 500 行，避免单次加载过多 - 循环内每处理 100 行调一次
ob_flush(); flush();，防止 PHP 输出缓冲撑爆 - 加
set_time_limit(0)防止超时中断（线上需评估合理性） - 如需导出超 10 万行，建议改用队列异步生成文件 + 前端轮询下载链接
Yii2 中复用导出逻辑的常见坑
很多人封装成静态方法或 trait，但容易忽略两点：
-
header()只能发一次，多次调用会报「headers already sent」——确保整个请求生命周期只走一次导出分支 - 若导出逻辑里用了
Yii::$app->response->sendFile()，就不能再用fopen('php://output')，二者互斥 - 自定义 GridView 导出按钮时，注意表单提交的
actionURL 必须指向纯导出 action，不能混用渲染视图的 action
最易被忽略的是：导出 CSV 本质是「终止当前响应流程」，一旦开始写 php://output，就不能再 render view、不能 redirect、不能抛异常——它不是普通业务逻辑，而是一次性输出终结。
