使用 PHP 数组生成 CSV 文件的完整教程-php教程-PHP中文网

使用 PHP 数组生成 CSV 文件的完整教程

聖光之護

发布： 2025-07-10 18:46:02

原创

793人浏览过

使用 php 数组生成 csv 文件的完整教程

本文旨在指导开发者如何使用 PHP 将两个或多个数组的数据合并并导出为 CSV 文件。我们将详细介绍如何正确地组织数组数据，以及如何使用 PHP 内置函数 fputcsv() 来生成符合 CSV 格式要求的文件内容，并提供两种实现代码示例。

在 PHP 中，将数组数据导出到 CSV 文件是一个常见的任务。 CSV (Comma Separated Values) 格式是一种简单的文本文件格式，用于存储表格数据，其中每一行代表一个数据记录，每个字段之间用逗号分隔。PHP 提供了强大的文件处理功能，结合数组操作，可以轻松生成 CSV 文件。

理解数组结构与 CSV 格式

要生成正确的 CSV 文件，首先需要理解数组的结构与 CSV 格式之间的对应关系。假设我们有两个数组 $first_array 和 $second_array，分别包含要写入 CSV 文件的两列数据。我们需要将这两个数组按照索引对应的方式合并成一个二维数组，其中每一行代表 CSV 文件中的一行数据。

例如，如果 $first_array 包含 ['KDS-1655B', 'KS-9916']，$second_array 包含 ['PRODUCTNAME1', 'PRODUCTNAME2']，那么我们期望生成的 CSV 文件内容如下：

立即学习“PHP免费学习笔记（深入）”；

firstheader,secondheader
KDS-1655B,PRODUCTNAME1
KS-9916,PRODUCTNAME2

登录后复制

为了实现这种格式，我们需要创建一个新的数组，将 $first_array 和 $second_array 中相同索引的元素组合成一个子数组。

合并数组数据的代码实现

PHP 并没有提供直接合并两个数组并按索引对应生成新数组的内置函数。因此，我们需要手动编写代码来实现这个功能。以下是一个示例：

<?php

$first_array = ['KDS-1655B', 'KS-9916', 'KDS-1197'];
$second_array = ['PRODUCTNAME1', 'PRODUCTNAME2', 'PRODUCTNAME3'];

$data = [];
$size = count($first_array);

for ($i = 0; $i < $size; $i++) {
    $data[] = [$first_array[$i], $second_array[$i]];
}

print_r($data); // 输出合并后的数组
?>

登录后复制

这段代码首先初始化一个空数组 $data。然后，使用 for 循环遍历 $first_array (或 $second_array，因为它们应该具有相同的长度)。在循环中，我们将 $first_array[$i] 和 $second_array[$i] 组合成一个新的数组 [$first_array[$i], $second_array[$i]]，并将其添加到 $data 数组中。

AI角色脑洞生成器

一键打造完整角色设定，轻松创造专属小说漫画游戏角色背景故事

176

查看详情

生成 CSV 文件的代码实现

现在我们已经有了包含所有数据的二维数组 $data，接下来就可以使用 fputcsv() 函数生成 CSV 文件了。 fputcsv() 函数接受一个文件指针、一个数组和一个分隔符作为参数，并将数组中的元素按照 CSV 格式写入到文件中。

以下是一个完整的示例代码：

<?php

$first_array = ['KDS-1655B', 'KS-9916', 'KDS-1197'];
$second_array = ['PRODUCTNAME1', 'PRODUCTNAME2', 'PRODUCTNAME3'];

$filename = 'mycsv.csv';
$delimiter = ',';

// 合并数组
$data = [];
$size = count($first_array);
for ($i = 0; $i < $size; $i++) {
    $data[] = [$first_array[$i], $second_array[$i]];
}

// 打开内存流
$f = fopen('php://memory', 'w');

// 写入 CSV 头部
$headings = ['firstheader', 'secondheader'];
fputcsv($f, $headings, $delimiter);

// 写入 CSV 数据
foreach ($data as $row) {
    fputcsv($f, $row, $delimiter);
}

// 重置文件指针
fseek($f, 0);

// 设置 HTTP 头部
header('Content-Type: text/csv');
header('Content-Disposition: attachment; filename="' . $filename . '";');

// 输出 CSV 数据
fpassthru($f);

// 关闭文件指针
fclose($f);

exit();

?>

登录后复制

这段代码首先定义了文件名 $filename 和分隔符 $delimiter。然后，打开一个内存流 'php://memory'，这允许我们在内存中创建文件，而无需实际写入磁盘。接下来，使用 fputcsv() 函数写入 CSV 头部，即列名。然后，使用 foreach 循环遍历 $data 数组，并使用 fputcsv() 函数将每一行数据写入到文件中。

在数据写入完成后，使用 fseek($f, 0) 将文件指针重置到文件开头。然后，设置 HTTP 头部，告诉浏览器这是一个 CSV 文件，并指定文件名。最后，使用 fpassthru($f) 将文件内容输出到浏览器，并使用 fclose($f) 关闭文件指针。

另一种代码实现

以下是另一种实现方式，直接在循环中将数据写入文件：

<?php

$first_array = ['KDS-1655B', 'KS-9916', 'KDS-1197'];
$second_array = ['PRODUCTNAME1', 'PRODUCTNAME2', 'PRODUCTNAME3'];

$csv_filename = 'mycsv.csv';
$csv_header = ['firstheader', 'secondheader'];

header('Content-Type: text/csv');
header('Content-Disposition: attachment; filename="' . $csv_filename . '";');

$fp = fopen('php://memory', 'w');

fputcsv($fp, $csv_header);

$size = count($first_array);
for ($i = 0; $i < $size; $i++) {
    fputcsv($fp, [$first_array[$i], $second_array[$i]]);
}

fseek($fp, 0);
fpassthru($fp);

fclose($fp);

exit();

?>

登录后复制

这种方法避免了先合并数组，直接在循环中调用 fputcsv() 函数，代码更简洁。

注意事项

数组长度一致性： 确保要合并的数组具有相同的长度。如果数组长度不一致，可能会导致数据错位或错误。
数据类型处理： fputcsv() 函数会将所有数据都视为字符串。如果数组中包含数字或其他类型的数据，需要根据需要进行类型转换。
分隔符和包围符： fputcsv() 函数允许自定义分隔符和包围符。默认情况下，分隔符是逗号 (,)，包围符是双引号 ("). 如果数据中包含逗号或双引号，需要使用包围符将其包围起来，以避免解析错误。
字符编码： CSV 文件的字符编码也很重要。常见的字符编码包括 UTF-8 和 GBK。如果数据包含中文或其他特殊字符，建议使用 UTF-8 编码，并在 HTTP 头部中指定字符编码，例如：header('Content-Type: text/csv; charset=UTF-8');

总结

本文详细介绍了如何使用 PHP 将两个或多个数组的数据合并并导出为 CSV 文件。我们学习了如何正确地组织数组数据，以及如何使用 fputcsv() 函数生成符合 CSV 格式要求的文件内容。通过本文提供的示例代码和注意事项，您可以轻松地在 PHP 项目中实现 CSV 文件的生成和导出功能。

以上就是使用 PHP 数组生成 CSV 文件的完整教程的详细内容，更多请关注php中文网其它相关文章！