如何在 str_getcsv 中正确转义分隔符以避免意外分割

在PHP开发中，使用str_getcsv解析CSV格式字符串时，如果字段内容本身包含分隔符，没有正确处理就会导致字段被错误拆分，得到不符合预期的结果。要解决这个问题，需要理解str_getcsv的参数含义，正确配置转义规则。

str_getcsv函数参数说明

str_getcsv的完整函数签名如下：

array str_getcsv ( string $input [, string $delimiter = "," [, string $enclosure = '"' [, string $escape = "\" ]]] )

各个参数的作用：

• input：要解析的CSV格式字符串
• delimiter：字段分隔符，默认是逗号
• enclosure：字段包裹符，默认是双引号，用于标记字段内容的边界
• escape：转义符，默认是反斜杠，用于在包裹符内部转义特殊字符

使用包裹符转义分隔符

最常见的方式是用包裹符把包含分隔符的字段内容包裹起来，str_getcsv会把包裹符内部的内容当作一个完整字段，不会根据分隔符拆分。

<?php
// 字段内容包含逗号分隔符
$csvStr = '姓名,简介,"张三,男,25岁",地址';
$result = str_getcsv($csvStr);
print_r($result);
// 输出结果
// Array
// (
//     [0] => 姓名
//     [1] => 简介
//     [2] => 张三,男,25岁
//     [3] => 地址
// )
?>

这里第三个字段的内容包含逗号，用双引号包裹后，解析时会保留完整的字段内容，不会被拆分成多个字段。

包裹符内部的转义处理

如果字段内容本身包含包裹符，需要在包裹符前添加转义符，默认转义符是反斜杠，也可以自定义转义符。

<?php
// 字段内容包含双引号包裹符
$csvStr = '产品名,""高性能"笔记本电脑",价格';
$result = str_getcsv($csvStr);
print_r($result);
// 输出结果
// Array
// (
//     [0] => 产品名
//     [1] => "高性能"笔记本电脑
//     [2] => 价格
// )
?>

如果自定义转义符为井号，示例如下：

<?php
$csvStr = '产品名,#"高性能#"笔记本电脑,价格';
$result = str_getcsv($csvStr, ',', '"', '#');
print_r($result);
// 输出结果
// Array
// (
//     [0] => 产品名
//     [1] => "高性能"笔记本电脑
//     [2] => 价格
// )
?>

自定义分隔符的转义场景

当CSV使用的不是默认逗号分隔符时，同样可以用包裹符处理包含自定义分隔符的字段内容。

<?php
// 使用竖线作为分隔符
$csvStr = '姓名|简介|"李四|女|28岁"|地址';
$result = str_getcsv($csvStr, '|');
print_r($result);
// 输出结果
// Array
// (
//     [0] => 姓名
//     [1] => 简介
//     [2] => 李四|女|28岁
//     [3] => 地址
// )
?>

注意事项

• 包裹符必须成对出现，否则会导致解析异常
• 转义符仅在包裹符内部生效，外部的分隔符不会被转义符影响
• 如果字段内容既包含分隔符又包含包裹符，需要同时做好包裹和转义处理
• 生成CSV字符串时，也要遵循同样的规则，避免出现解析不一致的问题

str_getcsvCSV转义分隔符处理PHP修改时间：2026-07-07 10:33:11