PHP is developed and maintained by a global community of contributors.
The PHP Foundation helps fund this work. If PHP is part of your business or projects, consider sponsoring the Foundation.
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
SplFileObject::fgetcsv — Получает строку из файлового указателя и разбирает по CSV-полям
$separator = ",", string $enclosure = "\"", string $escape = "\\"): array|falseМетод получает строку из CSV-файла и возвращает массив с прочитанными полями.
Замечание:
Функция учитывает региональные настройки, поэтому иногда неправильно разбирает данные в отдельных однобайтовых кодировках, если значение константы
LC_CTYPEравноen_US.UTF-8.
separator
Параметр устанавливает символ-разделитель полей и принимает только один однобайтовый символ.
Значение по умолчанию равно запятой — , или символу, который
установили методом SplFileObject::setCsvControl().
enclosure
Параметр устанавливает символ-ограничитель значений в полях и принимает
только один однобайтовый символ. Значение по умолчанию равно двойной кавычке — "
или значению, которое установили методом
SplFileObject::setCsvControl().
escape
Параметр устанавливает символ экранирования и принимает не больше одного однобайтового символа.
Значение по умолчанию равно обратному слешу
\ или значению, которое установили методом
SplFileObject::setCsvControl().
Пустая строка "" отключает внутренний механизм экранирования.
Дублирование символа enclosure
внутри обозначенных символом границ
вернёт в результате разбора входного потока
один символ enclosure.
Параметр escape работает по-другому:
при добавлении символа escape
перед символом enclosure
оба символа вернутся в результате разбора,
поэтому со стандартными значениями параметров CSV-строка наподобие
"a""b","c\"d" разберётся на два поля —
a"b и c\"d.
Начиная с PHP 8.4.0 полагаться на значение по умолчанию,
которое содержит параметр escape, не рекомендуют.
Значение потребуется указать явно: позиционно,
как именованный аргумент
или методом SplFileObject::setCsvControl().
Строка в CSV-формате иногда перестаёт соответствовать стандарту » RFC 4180
или не выдерживает обмена информацией с PHP-функциями
для работы с CSV-строками, если для символа экранирования escape устанавливают значение,
которое отличается от пустой строки "".
Значение по умолчанию для параметра escape — "\\",
поэтому рекомендуют явно указывать пустую строку. Значение по умолчанию изменят в будущей версии PHP, но не раньше PHP 9.0.
Метод возвращает массив, который содержит данные прочитанной строки, или false, если возникла ошибка.
Замечание:
Пустая строка в CSV-файле возвращается как массив с единственным элементом
null, если только через побитовое ИЛИ не указали константыSplFileObject::SKIP_EMPTY | SplFileObject::DROP_NEW_LINE, с которыми пустые строки пропускаются.
Функция выбрасывает ошибку ValueError,
если значение аргумента separator или enclosure
не равно одному байту.
Функция выбрасывает ошибку ValueError,
если значение аргумента escape не равно одному байту или пустой строке.
| Версия | Описание |
|---|---|
| 8.4.0 |
Вызов функции без явной передачи аргумента escape
устарел.
|
| 7.4.0 |
Теперь параметр escape принимает пустую строку
для отключения внутреннего механизма экранирования.
|
Пример #1 Пример получения и разбора строки по CSV-полям методом 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::READ_CSV
