fputcsv

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

fputcsv — Форматує рядок у вигляді CSV і записує його у файловий покажчик

Опис

fputcsv(    resource $stream,    array $fields,    string $separator = ",",    string $enclosure = "\"",    string $escape = "\\",    string $eol = "\n"): int|false

fputcsv() форматує рядок (переданий у вигляді масиву fields) у вигляді CSV і записує її (закінчуючи перекладом рядка) у вказаний файл stream

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

stream

Вказівник на файл повинен бути коректним і вказувати на файл, успішно відкритий функціями fopen() або fsockopen() (і все ще не закритий функцією fclose()

fields

Масив рядків (string).

separator

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

enclosure

Додатковий параметр enclosure встановлює обмежувач полів (тільки один однобайтовий символ).

escape

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

eol

Необов'язковий параметр eol задає послідовність кінця рядка, що настроюється.

Зауваження :

Якщо символ enclosure міститься в полі, він буде екранований шляхом його подвоєння, якщо йому не передує escape

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

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

список змін

Версия	Опис
8.1.0	Додано необов'язковий параметр eol
7.4.0	Тепер параметр escape може приймати порожній рядок для вимкнення пропрієтарного механізму екранування.

Приклади

Приклад #1 Приклад використання fputcsv()****

Loading...
▶

Наведений вище приклад запише у файл file.csvследующее:

aaa,bbb,ccc,dddd
123,456,789
"""aaa""","""bbb"""

Примітки

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

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

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