Форматирует строку в виде CSV и записывает её в файловый указатель


(PHP 5 >= 5.1.0)

fputcsvФорматирует строку в виде CSV и записывает её в файловый указатель

Описание

int fputcsv ( resource $handle , array $fields [, string $delimiter = "," [, string $enclosure = '"' [, string $escape_char = "\" ]]] )

fputcsv() форматирует строку (переданную в виде массива fields) в виде CSV и записывает её (заканчивая переводом строки) в указанный файл handle.

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

handle

Указатель на файл должен быть корректным и указывать на файл, успешно открытый функциями fopen() или fsockopen() (и все еще не закрытым функцией fclose()).

fields

Массив значений.

delimiter

Дополнительный параметр delimiter устанавливает разделитель полей (только один символ).

enclosure

Дополнительный параметр enclosure устанавливает ограничитель полей (только один символ).

escape_char

Необязательный параметр escape_char задает экранирубщий символ (только один символ).

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

Возвращает длину записанной строки или FALSE в случае возникновения ошибки.

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

Версия Описание
5.5.4 Добавлен параметр escape_char

Примеры

Пример #1 Пример использования fputcsv()

<?php

$list 
= array (
    array(
'aaa''bbb''ccc''dddd'),
    array(
'123''456''789'),
    array(
'"aaa"''"bbb"')
);

$fp fopen('file.csv''w');

foreach (
$list as $fields) {
    
fputcsv($fp$fields);
}

fclose($fp);
?>

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

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

Примечания

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

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

  • fgetcsv() - Читает строку из файла и производит разбор данных CSV