PHP Manual
SplFileObject
Получить строку из файла и ее разбор как поля CSV

SplFileObject::fgetcsv

(PHP 5 >= 5.1.0, PHP 7)

SplFileObject::fgetcsv — Получить строку из файла и ее разбор как поля CSV

Описание

public SplFileObject::fgetcsv ( string $delimiter = "," , string $enclosure = "\"" , string $escape = "\\" ) : array

Получает строку из файла и разбирает ее в соответствии с форматом CSV. Результаты разбора возвращает в виде массива.

Замечание:
Эта функция принимает во внимание настройки локали. К примеру, если LC_CTYPE установлена в en_US.UTF-8, то файлы в однобайтовой кодировке будут неправильно прочитаны этой функцией.

Список параметров

delimiter: Разделитель полей (только один символ). По умолчанию это запятая или символ, который был задан методом SplFileObject::setCsvControl().
enclosure: Символ ограничителя полей (максимум один символ). По умолчанию это двойная кавычка или символ, который был задан методом SplFileObject::setCsvControl(). Пустая строка ("") отключает проприетарный механизм экранирования.

Замечание: Обычно символ enclosure экранируется внутри поля путем его удваивания; однако, символ escape в качестве альтернативы. Поэтому значения по умолчанию этих параметров "" и \" имеют одинаковое значение. Помимо разрешения экранировать символ enclosure символ escape не имеет особого смысла; он даже не предназначен для самого экранирования.
escape: Экранирующий символ (только один символ). По умолчанию это обратный слеш (\) или символ, который был задан методом SplFileObject::setCsvControl().

Возвращаемые значения

Возвращает массив содержащий данные прочитанной строки или false в случае ошибки.

Замечание:
Пустая строка CSV-файла будет возвращаться в виде массива, содержащего единственный элемент null, если не используется SplFileObject::SKIP_EMPTY | SplFileObject::DROP_NEW_LINE, и в этом случае пустые строки пропускаются.

Список изменений

Версия	Описание
7.4.0	Теперь параметр `escape` может принимать пустую строку для отключения проприетарного механизма экранирования.

Примеры

Пример #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

Смотрите также

SplFileObject::setCsvControl() - Устанавливает символы разделителя, обертывания и экранирования для CSV
SplFileObject::setFlags() - Устанавливает флаги для SplFileObject
SplFileObject::READ_CSV
SplFileObject::current() - Получить текущую строки файла