fgetcsv

(PHP 4, PHP 5, PHP 7, PHP 8)

fgetcsv — Читає рядок із файлу та проводить розбір даних CSV

Опис

fgetcsv(    resource $stream,    ?int $length = null,    string $separator = ",",    string $enclosure = "\"",    string $escape = "\\"): array|false

Данная функция похожа на функциюfgets(), з тією різницею, що вона здійснює аналіз рядка на наявність записів у форматі CSV і повертає знайдені поля як масив.

Зауваження :

Ця функція враховує налаштування локалі. Наприклад, якщо LANGустановлена вen_US.UTF-8, то файли в однобайтовому кодуванні будуть неправильно прочитані цією функцією.

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

stream

Коректний файловий покажчик на файл, успішно відкритий за допомогою fopen() popen() або fsockopen()

length

Повинний бути більшим за найдовший рядок (у символах), знайдений у CSV-файлі (включаючи завершальний символ кінця рядка). В іншому випадку, рядок буде розбитий на шматки довжиною в length символів, якщо місце розриву нічого очікувати всередині обмежувачів полів (enclosure).

Відсутність цього параметра (або встановлення його в 0 або **null**починаючи з PHP 8.0.0) призведе до того, що довжина рядка буде не обмежена. Це може зашкодити швидкості виконання.

separator

Необов'язковий параметр separator встановлює роздільник поля (лише один однобайтовий символ).

enclosure

Необов'язковий параметр enclosure встановлює символ обмежувача поля (лише один однобайтовий символ).

escape

Необов'язковий параметр escape встановлює екрануючий символ (не більше одного однобайтового символу). Порожня стрічка ("") відключає пропрієтарний механізм екранування.

Зауваження: Зазвичай символ enclosure екранується всередині поля шляхом його подвоювання; однак, символ escape як альтернатива. Тому значення за промовчанням цих параметрів ""и\" мають однакове значення. Крім дозволу екранувати символ enclosureсимволescape немає особливого сенсу; він навіть не призначений для самого екранування.

Значення, що повертаються

Повертає індексований масив із прочитаними полями у разі успішного виконання або **false**в случае возникновения ошибки.

Зауваження :

Порожній рядок CSV-файлу буде повернуто як масив, що містить єдиний елемент null, помилки в даному випадку не виникне.

Зауваження: Якщо виникають проблеми з розпізнаванням PHP кінців рядків під час читання або створення файлів на Macintosh-сумісному комп'ютері, увімкнення опції auto_detect_line_endingsможет помочь решить проблему.

список змін

Версия	Опис
8.0.0	Параметрlength тепер припускає значення null
7.4.0	Тепер параметр escape може приймати порожній рядок для вимкнення пропрієтарного механізму екранування.

Приклади

Приклад #1 Читання та виведення на екран вмісту файлу CSV

Loading...
▶

Дивіться також

• str_getcsv() - Розбирає CSV-рядки в масив
• explode() - Розбиває рядок за допомогою роздільника
• file() - Читає вміст файлу та поміщає його в масив
• pack() - Упакувати дані у бінарний рядок
• fputcsv() - Форматує рядок у вигляді CSV і записує його у файловий покажчик