如何在str_getcsv()中正确转义分隔符

在PHP开发中，str_getcsv()函数是解析CSV格式字符串的常用工具，默认情况下它使用逗号作为字段分隔符，但如果CSV内容本身包含逗号，就会出现解析错误的问题，这时候就需要正确处理分隔符的转义逻辑。

str_getcsv()函数基本参数

str_getcsv()的完整参数列表如下，其中分隔符、包围符、转义符的配置直接决定解析的准确性：

常见分隔符冲突场景

下面是一段包含逗号的内容，直接用str_getcsv()解析会出现字段拆分错误：

<?php
$csv_str = '张三,18,北京市,海淀区';
$result = str_getcsv($csv_str);
print_r($result);
// 预期结果：["张三", "18", "北京市,海淀区"]
// 实际结果：["张三", "18", "北京市", "海淀区"] 字段被错误拆分
?>

正确转义分隔符的方法

方法一：使用默认包围符包裹含分隔符的字段

CSV标准约定，如果字段内容包含分隔符，用双引号（默认包围符）包裹该字段即可，str_getcsv()会自动识别：

<?php
// 正确格式的CSV字符串，地址字段用双引号包裹
$csv_str = '张三,18,"北京市,海淀区"';
$result = str_getcsv($csv_str);
print_r($result);
// 输出结果：Array ( [0] => 张三 [1] => 18 [2] => 北京市,海淀区 )
?>

方法二：自定义分隔符与转义规则

如果CSV使用的不是默认逗号分隔符，比如用竖线|作为分隔符，需要手动指定delimiter参数：

<?php
// 使用竖线作为分隔符的CSV字符串
$csv_str = '张三|18|北京市|海淀区';
$result = str_getcsv($csv_str, '|');
print_r($result);
// 输出结果：Array ( [0] => 张三 [1] => 18 [2] => 北京市 [3] => 海淀区 )
?>

如果字段内容同时包含自定义分隔符和默认包围符，需要配合escape参数处理转义：

<?php
// 内容包含竖线分隔符和双引号，用反斜杠转义双引号
$csv_str = '张三|18|"北京市|海淀区"|男';
$result = str_getcsv($csv_str, '|', '"', '\');
print_r($result);
// 输出结果：Array ( [0] => 张三 [1] => 18 [2] => 北京市|海淀区 [3] => 男 )
?>

注意事项

• 如果CSV内容中的包围符本身需要作为普通字符出现，需要在前面加转义符，比如双引号内容里的双引号要写成"
• 不要随意修改escape参数的默认值，除非你明确知道CSV的转义规则和你设置的字符匹配
• 解析从文件读取的CSV内容时，需要先用file_get_contents()获取字符串再传入str_getcsv()，避免换行符干扰解析

在生成CSV字符串时，建议统一使用双引号包裹所有字段，即使内容不包含分隔符，这样可以避免后续解析时的分隔符冲突问题，提升代码的兼容性。

str_getcsvCSV转义分隔符处理PHP修改时间：2026-06-23 00:57:28