SplFileObject::fputcsv
Write a field array as a CSV line
Description
public intfalse SplFileObject::fputcsv(
array $fields
,
string $separator
= ",",
string $enclosure
= "\"",
string $escape
= "\\",
string $eol
= "\n"
)
Parameters
-
fields
-
An 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.
Warning
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.
Note:
If an enclosure
character is contained in a field,
it will be escaped by doubling it, unless it is immediately preceded by an
escape
.
Return Values
Returns the length of the written string or false
on failure.
Returns false
, and does not write the CSV line to the file, if the
separator
or enclosure
parameter is not a single character.
Errors/Exceptions
An E_WARNING
level error is issued if the
separator
or enclosure
parameter is not a single character.
Examples
Example #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"""
See Also
- fputcsv
- SplFileObject::fgetcsv