PHP通过POST获取的CSV格式字符串如何正确生成CSV文件？

问题根源分析 #

• 误用str_getcsv：该函数的第二个参数是字段分隔符（默认逗号），而非行分隔符，用它拆分整个CSV大字符串是错误用法。
• 换行符不统一：服务器返回的CSV可能使用\r\n、\n或\r等不同换行符，直接用平台相关的PHP_EOL拆分会导致失败。
• 写入未做转义：直接写入原始字符串会导致含特殊字符（逗号、引号、换行）的字段无法被Excel正确识别，出现列错位。

分步解决方案 #

1. 统一换行符并拆分CSV行 #

先将所有换行符统一为\n，再拆分字符串为行数组，同时过滤空行：

// 统一所有换行符为\n
$normalizedData = str_replace(["\r\n", "\r"], "\n", $data);
// 拆分并过滤空行
$csvRows = array_filter(explode("\n", $normalizedData), function($row) {
    return trim($row) !== '';
});

2. 逐行解析CSV字段 #

对每一行使用str_getcsv解析为字段数组（如果CSV用非逗号分隔，比如制表符，需指定第二个参数）：

$parsedRows = [];
foreach ($csvRows as $row) {
    // 默认逗号分隔，若为制表符则改为 str_getcsv($row, "\t")
    $fields = str_getcsv($row);
    $parsedRows[] = $fields;
}

3. 写入规范CSV文件 #

用fputcsv逐行写入，该函数会自动处理特殊字符的转义，确保Excel能正确识别列：

$outputFile = fopen('result.csv', 'w');
if (!$outputFile) {
    exit('无法创建输出文件');
}

// 逐行写入
foreach ($parsedRows as $fields) {
    // 同样，若为非逗号分隔，需指定第三个参数，比如 fputcsv($outputFile, $fields, "\t")
    fputcsv($outputFile, $fields);
}

fclose($outputFile);

完整示例代码 #

// 假设已通过curl获取到原始CSV字符串 $data
$normalizedData = str_replace(["\r\n", "\r"], "\n", $data);
$csvRows = array_filter(explode("\n", $normalizedData), fn($row) => trim($row) !== '');

$outputFile = fopen('规范CSV文件.csv', 'w');
if (!$outputFile) {
    die('无法打开输出文件');
}

foreach ($csvRows as $row) {
    $fields = str_getcsv($row);
    fputcsv($outputFile, $fields);
}

fclose($outputFile);

注意事项 #

• 如果你的CSV使用其他字段分隔符（如制表符\t、分号;），需在str_getcsv和fputcsv中明确指定分隔符参数。
• 若CSV包含带引号的字段，str_getcsv和fputcsv会自动处理引号的转义与解析，无需手动操作。

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