fputcsv()

1. 定义

将一个数组格式化为CSV后写入通过函数fopen()打开的文件句柄。 成功时返回写入的字符串长度,失败则返回FALSE。

2. 语法

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

3. 参数说明

参数 可选性 数据类型 描述
$handle 必需 资源类型 文件句柄,通过fopen()函数打开的文件资源
$fields 必需 数组 规定要写入的数组值
$delimiter 可选 字符串 字段分界符,只允许一个字符,默认为逗号,
$enclosure 可选 字符串 字段环绕符,只允许一个字符,默认为双引号"
$escape_char 可选 字符串 转义字符,只允许一个字符,默认为反斜杠\\

4. 示例

<?php

// fputcsv()
// 将一个数组格式化为`CSV`后写入通过函数`fopen()`打开的文件句柄

$handle = fopen(__DIR__.'/test.csv', 'w');
$arr = [
    ['一个接口名','一段简要描述','一段长长的描述','功能说明'],
    ['一个接口名2','一段简要描述','一段长长的描述','功能说明'],
    ['一个接口名3','一段简要描述','一段长长的描述','功能说明'],
];
foreach ($arr as $key => $value) {
    fputcsv($handle, $value);
}
fclose($handle);

echo file_get_contents(__DIR__.'/test.csv');
/* 输出:
一个接口名,一段简要描述,一段长长的描述,功能说明
一个接口名2,一段简要描述,一段长长的描述,功能说明
一个接口名3,一段简要描述,一段长长的描述,功能说明
*/

5. 延展阅读

  • fgetcsv():从文件指针处读取一行字符,直到遇到换行符、文件末尾或者函数参数列表中指定的长度($length - 1)后停止,并对行中的 CSV 字段进行解析