(PHP 5 >= 5.1.0, PHP 7)
SplFileObject::fgetcsv — Получение строки файла и ее разбор в соответствии с CSV разметкой
$delimiter
= ","
[, string $enclosure
= "\""
[, string $escape
= "\\"
]]] )Извлекает строку из файла и разбирает ее в соответствии с форматом CSV. Результаты разбора возвращает в виде массива.
delimiter
Разделитель полей (один символ). По умолчанию это запятая или символ, который был задан методом SplFileObject::setCsvControl().
enclosure
Символ обрамления полей (один символ). По умолчанию это двойная кавычка или символ, который был задан методом SplFileObject::setCsvControl().
escape
Экранирующий символ (один символ). По умолчанию это обратный слеш (\) или символ, который был задан методом SplFileObject::setCsvControl().
Возвращает массив содержащий данные прочитанной строки или FALSE
в случае
ошибки.
Замечание:
Пустая строка CSV файла будет возвращаться в виде массива, содержащего единственный элемент
NULL
, если не включена опцияSplFileObject::SKIP_EMPTY | SplFileObject::DROP_NEW_LINE
, которая позволяет пропускать пустые строки.
Пример #1 Пример использования SplFileObject::fgetcsv()
<?php
$file = new SplFileObject("data.csv");
while (!$file->eof()) {
var_dump($file->fgetcsv());
}
?>
Пример #2 Пример использования SplFileObject::READ_CSV
<?php
$file = new SplFileObject("animals.csv");
$file->setFlags(SplFileObject::READ_CSV);
foreach ($file as $row) {
list($animal, $class, $legs) = $row;
printf("A %s is a %s with %d legs\n", $animal, $class, $legs);
}
?>
Contents of animals.csv
crocodile,reptile,4 dolphin,mammal,0 duck,bird,2 koala,mammal,4 salmon,fish,0
Результатом выполнения данного примера будет что-то подобное:
A crocodile is a reptile with 4 legs A dolphin is a mammal with 0 legs A duck is a bird with 2 legs A koala is a mammal with 4 legs A salmon is a fish with 0 legs