(PHP 5 >= 5.1.0, PHP 7, PHP 8)
fputcsv — 将行格式化为 CSV 并写入文件指针
$handle
, array $fields
, string $delimiter
= ','
, string $enclosure
= '"'
) : int
fputcsv() 将一行(用
fields
数组传递)格式化为 CSV
格式并写入由 handle
指定的文件。
handle
文件指针必须是有效的,必须指向由 fopen() 或 fsockopen() 成功打开的文件(并还未由 fclose() 关闭)。
fields
值的一个数组。
delimiter
可选的 delimiter
参数设定字段分界符(只允许一个字符)。
enclosure
可选的 enclosure
参数设定字段字段环绕符(只允许一个字符)。
返回写入字符串的长度, 或者在失败时返回 false
。
示例 #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"""
注意: 在读取在 Macintosh 电脑中或由其创建的文件时, 如果 PHP 不能正确的识别行结束符,启用运行时配置可选项 auto_detect_line_endings 也许可以解决此问题。