PHP 中使用 fputcsv 将数组转换为 CSV 文件

方法说明

PHP 提供了专门用于处理 CSV 文件的内置函数 fputcsv。该函数能够将数组按指定的分隔符（默认逗号）和 enclosure 字符（默认双引号）格式化为 CSV 行并写入文件指针。相比手动拼接字符串，使用此函数能自动处理包含分隔符或换行符的特殊字符，避免格式错乱。

操作步骤

第1步：准备待输出的二维数组

首先，定义一个包含多组数据的二维数组。每一子数组代表 CSV 文件中的一行记录。例如，我们创建一个包含地区、日期及销售额的销售数据数组：

<?php
$sales = array(
    array('east','2005-01-01','2005-02-01',12.54),
    array('west','2005-01-01','2005-02-01',546.33),
    array('south','2005-01-01','2005-02-01',93.26),
    array('north','2005-01-01','2005-02-01',945.21),
    array('All Regions','--','--',1597.34)
);
?>

第2步：以写入模式打开目标文件

使用 fopen 函数以 'w' 模式打开一个新的 CSV 文件。如果文件不存在则创建，如果存在则清空原内容。务必检查返回的文件指针资源，防止因权限问题导致程序中断。

$fh = fopen('file.csv','w') or die("Can't open file.csv");

第3步：遍历数组并写入 CSV 行

利用 foreach 循环遍历销售数组，将每个一维子数组作为参数传递给 fputcsv。该函数会自动将数组元素转换为符合 RFC 4180 标准的 CSV 行。

• 入口：已打开的文件句柄 $fh 和当前行的数组数据 $sales_line。
• 动作：fputcsv($fh, $sales_line)。
• 注意：若写入失败，fputcsv 将返回 false，此时应捕获错误以防数据损坏。

foreach ($sales as $sales_line) {
  if (fputcsv($fh, $sales_line) === false) {
    die("Can't write CSV line");
  }
}

第4步：关闭文件释放资源

所有数据写入完成后，必须调用 fclose 关闭文件句柄，确保数据真正落盘并释放系统资源。

fclose($fh) or die("Can't close file.csv");

完成判断

执行上述脚本后，在同级目录下将生成 file.csv。你可以使用 Excel、Google Sheets 或任何文本编辑器打开该文件，验证数据是否准确分行、分列显示，且特殊字符未出现编码错误或格式错位。

简要总结

通过结合 fopen、fputcsv 和 fclose，可以轻松实现 PHP 数组到 CSV 的高可靠转换。这种方法不仅代码简洁，而且能妥善处理复杂数据内容的转义问题，是数据导出功能的推荐实现方式。

以上就是php将数组转换成csv格式文件输出的详细内容，更多关于php程序设计方面的资料请关注本站其它相关文章！