(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 optional separator parameter sets the field
delimiter (one single-byte character only).
enclosure
The optional enclosure parameter sets the field
enclosure (one single-byte character only).
escape
The optional escape parameter sets the
escape character (at most one single-byte character).
An empty string ("") disables the proprietary escape mechanism.
eol
The optional eol parameter sets
a custom End of Line sequence.
When escape is set to anything other than an empty string
("") it can result in CSV that is not compliant with
» RFC 4180 or unable to survive a roundtrip
through the PHP CSV functions. The default for escape is
"\\" so it is recommended to set it to the empty string explicitly.
The default value will change in a future version of PHP, no earlier than 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 в разі помилки.
Returns false, and does not write the CSV line to the file, if the
separator or enclosure
parameter is not a single character.
An E_WARNING level error is issued if the
separator or enclosure
parameter is not a single character.
| Версія | Опис |
|---|---|
| 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"""