Yii框架ECSVExport导出CSV添加首行致表头异常求助

老哥，你碰到的表头错乱问题，核心是用r+模式打开文件后直接fputcsv的操作逻辑错了——这是覆盖写入，不是你想要的插入新行。当你用r+打开已生成好的CSV时，文件指针默认停在文件开头，执行fputcsv会直接从开头开始覆盖原内容，而不是把新行插到最前面。比如原表头第一行的organisation_path，前几个字符被version,1覆盖后，剩下的未被覆盖的字符（比如on_path）就会和新行内容粘在一起，自然就乱了。

方法1：读内容+拼新行重写（最省心） #

如果你的CSV文件体积不大，直接用这种方法最简便，一行读、一行拼、一行写搞定：

// 把原CSV内容全部读进来
$originalCsv = file_get_contents($path);
// 把新行拼在最前面，记得加换行符分隔
$newCsv = 'version,1' . PHP_EOL . $originalCsv;
// 写回文件
file_put_contents($path, $newCsv);

用PHP_EOL是为了适配Windows和Linux的换行差异，避免导出的CSV在不同系统里换行乱掉。

方法2：临时文件中转（适合大文件） #

要是导出的CSV特别大，一次性读进内存怕卡，可以用临时文件来中转，不用循环：

// 创建一个临时文件存内容
$tempFile = tempnam(sys_get_temp_dir(), 'temp_csv');
$tempHandle = fopen($tempFile, 'w');

// 先把新行写进去
fputcsv($tempHandle, ['version', '1']);

// 把原CSV的内容直接复制到临时文件里
$originalHandle = fopen($path, 'r');
stream_copy_to_stream($originalHandle, $tempHandle);
fclose($originalHandle);
fclose($tempHandle);

// 用临时文件替换原文件
rename($tempFile, $path);

这种方式不用把整个文件塞内存，大文件场景下更稳。

方法3：生成阶段直接插入（最推荐） #

其实最靠谱的是从源头解决——在ECSVExport生成CSV内容的时候就把首行加上，不用事后改文件：

// 假设你原来的导出代码是这样的
$exporter = new ECSVExport($dataProvider);
// 获取ECSVExport生成的CSV内容（不同版本可能方法名不同，比如getCsv()或render()）
$rawCsv = $exporter->render();
// 把新行拼在最前面
$finalCsv = 'version,1' . PHP_EOL . $rawCsv;
// 直接写入文件
file_put_contents($path, $finalCsv);

这种方式跳过了修改已有文件的步骤，完全避免了文件指针操作的坑，效率也最高。

内容的提问来源于stack exchange，提问作者user2935236