fputcsv
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
fputcsv — Format line as CSV and write to file pointer
Beschreibung
resource
$stream,array
$fields,string
$separator = ",",string
$enclosure = "\"",string
$escape = "\\",string
$eol = "\n"): int|false
fputcsv() formats a line (passed as a
fields array) as CSV and writes it (terminated by a
newline) to the specified file stream.
Parameter-Liste
-
stream -
Der Zeiger auf eine Datei muss gültig sein und auf eine Datei verweisen, die vorher erfolgreich mit fopen() oder fsockopen() geöffnet (und nicht bereits von fclose() geschlossen) wurde.
-
fields -
An array of strings.
-
separator -
The optional
separatorparameter sets the field delimiter (one single-byte character only). -
enclosure -
The optional
enclosureparameter sets the field enclosure (one single-byte character only). -
escape -
The optional
escapeparameter sets the escape character (at most one single-byte character). An empty string ("") disables the proprietary escape mechanism. -
eol -
The optional
eolparameter sets a custom End of Line sequence.
Hinweis:
If an
enclosurecharacter is contained in a field, it will be escaped by doubling it, unless it is immediately preceded by anescape.
Rückgabewerte
Returns the length of the written string Bei einem Fehler wird false zurückgegeben..
Changelog
| Version | Beschreibung |
|---|---|
| 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.
|
Beispiele
Beispiel #1 fputcsv() example
<?php
$list = array (
array('aaa', 'bbb', 'ccc', 'dddd'),
array('123', '456', '789'),
array('"aaa"', '"bbb"')
);
$fp = fopen('file.csv', 'w');
foreach ($list as $fields) {
fputcsv($fp, $fields);
}
fclose($fp);
?>
The above example will write the following to file.csv:
aaa,bbb,ccc,dddd 123,456,789 """aaa""","""bbb"""
Anmerkungen
Hinweis: Wenn PHP Zeilenendezeichen nicht richtig erkennt, entweder beim Lesen von Dateien auf einem Macintosh oder bei Dateien, die auf einem Macintosh erstellt wurden, kann die Option auto_detect_line_endings aktiviert werden.
Siehe auch
- fgetcsv() - Liest eine Zeile von der Position des Dateizeigers und prüft diese auf Komma-Separierte-Werte (CSV)
