Yii数据导出分扩展集成与手写逻辑两条路径：yii2-export适合快速导出但需处理乱码和CSV转义；手写推荐fputcsv导出CSV（UTF-8+BOM）、PhpSpreadsheet导出Excel（设中文字体、禁用公式），并注意内存、超时及分页控制。
Yii做数据导出，核心就两条路：用现成扩展快速集成，或手写逻辑精准控制。选哪条，取决于你对格式、性能、中文兼容性和维护成本的要求。
用 yii2-export 扩展一键导出 Excel / CSV / PDF
这是最省事的选择，尤其适合 GridView 场景，但得注意它默认依赖 phpoffice/phpspreadsheet，且 CSV 导出容易乱码或逗号截断。
- 先装扩展：
composer require kartik-v/yii2-export "@dev"（注意加@dev兼容较新 PHP 版本） -
ExportMenu::widget()必须传dataProvider，不能直接传数组；若数据已查好，需包装成ArrayDataProvider - 中文表头和内容乱码？在
exportConfig里加'encoding' => 'GBK'或改用'encoding' => 'UTF-8'并确保浏览器支持 UTF-8 BOM（CSV 场景下可手动加\xEF\xBB\xBF） - 导出 CSV 时字段含英文逗号、换行、双引号？
yii2-export默认不转义，会破坏单元格结构 —— 此时必须关掉它的 CSV 导出，自己手写
手写 CSV 导出：绕过乱码与格式断裂
当数据含用户输入文本（比如地址、备注）、存在英文逗号或换行时，fputcsv() 是最稳妥的底层方案，比字符串拼接 + str_replace() 可靠得多。
- 别用
iconv('utf-8', 'gb2312', ...)硬转 —— GBK/GB2312 不覆盖所有中文字符，推荐统一 UTF-8 + BOM 头：echo "\xEF\xBB\xBF"; - 必须用
fputcsv($fp, $row, ',', '"', '"')写入，而不是implode()；否则含换行的单元格会直接撕裂表格 - 响应头要设对：
header('Content-Type: text/csv; charset=UTF-8');和header('Content-Disposition: attachment; filename="data.csv"'); - 大数据量时禁用输出缓冲：
ob_end_clean();后再ob_start();，避免内存溢出
手写 Excel 导出：用 PhpSpreadsheet 替代淘汰的 PHPExcel
PHPExcel 已停止维护，phpoffice/phpspreadsheet 是唯一推荐路径。它不兼容旧代码里的 new \PHPExcel()，方法名和对象模型全变了。
- 创建实例是
$spreadsheet = new \PhpOffice\PhpSpreadsheet\Spreadsheet();，不是\PHPExcel - 设置单元格值用
$sheet->setCellValue('A1', '标题')，批量写可用fromArray()方法 - 中文字体显示为方块？需显式设置单元格样式：
$style = ['font' => ['name' => 'SimSun', 'size' => 10]];，然后$sheet->getStyle('A1:Z1000')->applyFromArray($style); - 导出大文件（>5 万行）时内存暴涨？关闭自动计算公式、禁用事件监听：
$spreadsheet->getCalculationEngine()->disableFormulaExecution();
导出前必做三件事：防崩、防错、防丢数据
很多导出功能上线后突然报错或导出空文件，问题往往不在导出逻辑本身，而在前置准备。
- 调大 PHP 限制：
ini_set('memory_limit', '1024M');和set_time_limit(0);—— 尤其在控制器 action 开头就加 - 禁用分页：
'pagination' => false必须设在ActiveDataProvider或查询对象上，否则只导当前页 - 数据源别用
asArray()后再加工 —— 某些字段（如日期、布尔）会丢失类型信息，建议在 query 阶段用select()显式指定字段和格式化表达式
导出不是“把数据扔进文件”，而是“按目标格式契约精确交付”。CSV 的引号包裹规则、Excel 的字体/公式/样式边界、HTTP 响应头的编码声明 —— 每一处不匹配，都会让前端打开文件时变成一坨乱码或错列。动手前，先确认你要交付的是给谁看、在哪打开、是否要二次编辑。
