本文旨在指导开发者如何使用 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 数组中。
生成 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 文件的生成和导出功能。
