PHP is developed and maintained by a global community of contributors.
The PHP Foundation helps fund this work. If PHP is part of your business or projects, consider sponsoring the Foundation.
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
fputcsv — 将行格式化为 CSV 并写入文件指针
$stream,$fields,$separator = ",",$enclosure = "\"",$escape = "\\",$eol = "\n"
fputcsv() 将一行（传递 fields 数组）格式化为
CSV，并将其写入（以 eol 终止）到指定的
stream。
stream文件指针必须是有效的，必须指向由 fopen() 或 fsockopen() 成功打开的文件(并还未由 fclose() 关闭)。
fieldsstring 数组。
separator
可选的 separator 参数，设置字段分隔符。必须是单字节字符。
enclosure
可选的 enclosure 参数，设置字段环绕符。必须是单字节字符。
escape
可选的 escape
参数，设置转义字符。必须是单字节字符或者空字符串。空字符串（""）禁用所有的转义机制。
在输入流中，enclosure 字符在引号字符串内可通过重复自身进行转义，解析后结果中将只保留一个
enclosure 字符。而 escape 字符的行为有所不同：若输入中出现
escape 字符与 enclosure
字符的组合序列，这两个字符都会保留在解析结果中。因此，在默认参数下，类似 "a""b","c\"d" 的 CSV
行将被解析为两个字段，分别为 a"b 和 c\"d。
从 PHP 8.4.0 开始，弃用依赖 escape 的默认值。需要通过位置或使用命名参数明确提供。
eol
可选的 eol 参数设置自定义行尾序列。
当 escape 被设置为非空字符串（""）时，
可能导致生成的 CSV 不符合 » RFC 4180 的要求，
或者无法通过 PHP CSV 函数的往返处理。
escape 的默认值是 "\\"，因此建议显式地将其设置为空字符串。
默认值将在未来的 PHP 版本中更改，不早于 PHP 9.0。
注意:
如果字段中包含
enclosure字符，则会通过将其双倍enclosure来进行转义，除非该字符前面紧接着一个escape。
返回写入字符串的长度， 或者在失败时返回 false。
| 版本 | 说明 |
|---|---|
| 8.4.0 | 现在已弃用依赖 escape 的默认值。 |
| 8.1.0 |
新增可选的 eol 参数。
|
| 7.4.0 |
escape 参数现在接受空字符串来禁用专有转义机制。
|
示例 #1 fputcsv() 示例
<?php
$list = [
['aaa', 'bbb', 'ccc', 'dddd'],
['123', '456', '789'],
['"aaa"', '"bbb"']
];
$fp = fopen('file.csv', 'w');
foreach ($list as $fields) {
fputcsv($fp, $fields, ',', '"', '');
}
fclose($fp);
?>以上示例会写入以下的 file.csv：
aaa,bbb,ccc,dddd 123,456,789 """aaa""","""bbb"""
