PHP fputcsv()直接传入字符串参数导致空输出问题排查

安全阿岳

2026-8-30

问题原因

核心是传参不符合fputcsv()的参数要求。
fputcsv的第二个参数必须是一维数组，数组每个元素对应CSV的一个单元格字段，函数拿到这个数组后，会自动处理逗号分隔、特殊字符转义、引号包裹这些CSV格式逻辑。
你第二段出错的代码里，循环拿到的$line是整行的逗号拼接字符串，不是拆分好的字段数组：

PHP 8.0及以上版本会直接抛出类型错误，如果你没开启错误显示，页面就会呈现空白
低版本PHP会抛出警告，同时因为参数类型不匹配，fputcsv直接返回false写入失败，没有任何有效内容输出，最终就拿到空结果。

这个函数从设计上就没有自动拆分整行字符串的逻辑，你给它传什么字段它就写什么字段，不会主动解析你提前拼好的整行逗号分隔字符串。

解决方法

两种可行方案：

方案1：沿用原有的字符串数据源，循环时先把字符串拆成字段数组再传入，也就是你第一段可正常运行的写法：

$data = array(
    'aaa,bbb,ccc,dddd',
    '123,456,789',
    '"aaa","bbb"',
);

$fp = fopen('php://output', 'wb');
    
foreach ($data as $line) {
    $val = explode(",", $line);
    fputcsv($fp, $val);
}

fclose($fp);

方案2（更推荐）：直接把数据源改成二维数组结构，每个子数组对应一行的所有字段，省掉循环里的explode操作，还能避免字段本身带逗号时，简单explode拆错列的问题：

$data = array(
    ['aaa', 'bbb', 'ccc', 'dddd'],
    ['123', '456', '789'],
    ['"aaa"', '"bbb"'],
);

$fp = fopen('php://output', 'wb');
    
foreach ($data as $fields) {
    fputcsv($fp, $fields);
}

fclose($fp);