(PHP 5 >= 5.4.0, PHP 7, PHP 8)
SplFileObject::fputcsv — Write a field array as a CSV line
$fields,$separator = ",",$enclosure = "\"",$escape = "\\",$eol = "\n"
Writes the fields array to the file
as a CSV line.
fieldsAn array of values.
separator
The field delimiter (one single-byte character only).
By default , or the value set by a prior call to
SplFileObject::setCsvControl().
enclosure
The field enclosure character (one single-byte character only).
By default " or the value set by a prior call to
SplFileObject::setCsvControl().
escape
The escape character (at most one single-byte character).
By default \ or the value set by a prior call to
SplFileObject::setCsvControl().
An empty string ("") disables the proprietary escape mechanism.
在输入流中，enclosure 字符在引号字符串内可通过重复自身进行转义，解析后结果中将只保留一个
enclosure 字符。而 escape 字符的行为有所不同：若输入中出现
escape 字符与 enclosure
字符的组合序列，这两个字符都会保留在解析结果中。因此，在默认参数下，类似 "a""b","c\"d" 的 CSV
行将被解析为两个字段，分别为 a"b 和 c\"d。
As of PHP 8.4.0, depending on the default value of
escape is deprecated.
It needs to be provided explicitly either positionally or by the use
of Named Arguments,
or by a call to SplFileObject::setCsvControl().
eol
The optional eol parameter sets
a custom End of Line sequence.
当 escape 被设置为非空字符串（""）时，
可能导致生成的 CSV 不符合 » RFC 4180 的要求，
或者无法通过 PHP CSV 函数的往返处理。
escape 的默认值是 "\\"，因此建议显式地将其设置为空字符串。
默认值将在未来的 PHP 版本中更改，不早于 PHP 9.0。
注意:
If an
enclosurecharacter is contained in a field, it will be escaped by doubling it, unless it is immediately preceded by anescape.
Returns the length of the written string 或者在失败时返回 false.
| 版本 | 说明 |
|---|---|
| 8.4.0 | 现在已弃用依赖 escape 的默认值。 |
| 8.1.0 |
The optional eol parameter has been added.
|
| 7.4.0 |
The escape parameter now also accepts an empty
string to disable the proprietary escape mechanism.
|
示例 #1 SplFileObject::fputcsv() example
<?php
$list = array (
array('aaa', 'bbb', 'ccc', 'dddd'),
array('123', '456', '789'),
array('"aaa"', '"bbb"')
);
$file = new SplFileObject('file.csv', 'w');
foreach ($list as $fields) {
$file->fputcsv($fields);
}
?>The above example will write the following to file.csv:
aaa,bbb,ccc,dddd 123,456,789 """aaa""","""bbb"""