详解PHP导入导出CSV文件

发布时间：2024/03/01

下面我来详细讲解“详解PHP导入导出CSV文件”的完整攻略。

1. CSV文件格式简介

CSV（Comma Separated Values）文件指以逗号为分隔符进行编码的文本文件。CSV文件可以通过电子表格软件（如Excel）打开、编辑和保存，也可以用纯文本编辑器进行编辑。CSV文件可以存储所有不含格式的文本数据，它是一种常见的数据交换格式。CSV文件的每行是一个数据记录，每个字段之间使用逗号进行分隔，字段中若有逗号需要加上双引号或者单引号进行包裹，例如："hello,world"。

2. 导出CSV文件

2.1 准备数据

首先，我们需要准备好要导出的数据。假设我们要导出的数据是用户信息，包含用户名和邮箱地址，我们可以将数据存储在数组中：

$data = [
    ['username', 'email'], // 表头
    ['张三', 'zhangsan@example.com'],
    ['李四', 'lisi@example.com'],
    ['王五', 'wangwu@example.com'],
];

2.2 生成CSV文件内容

将数据转换成CSV文件格式的内容，需要用到PHP的文件处理函数和字符串函数。我们可以通过循环遍历数组，将每一行数据转换成CSV格式的字符串。例如：

$fileContent = '';
foreach ($data as $row) {
    // 将每个字段使用双引号包裹，并用逗号进行分隔
    $fileContent .= '"' . implode('","', $row) . '"' . "\n";
}

在上面的代码中，implode('","', $row)将每一行数据的字段用双引号包裹，用逗号进行分隔，\n表示换行符。

2.3 输出CSV文件

将生成的CSV文件内容输出到浏览器或者保存为文件，需要使用PHP的文件处理函数。例如保存为文件：

$filename = 'user.csv';
// 设置HTTP响应头，告诉浏览器下载文件
header("Content-type: application/octet-stream");
header("Content-Disposition: attachment; filename=$filename");

// 将CSV文件内容写入到文件
file_put_contents($filename, $fileContent);

上面的代码会弹出文件下载对话框，并自动下载文件到本地硬盘。

另一种输出方式是直接将CSV文件内容输出到浏览器：

// 设置HTTP响应头，告诉浏览器文件类型是CSV格式
header('Content-Type: application/csv');
header('Content-Disposition: attachment; filename="user.csv";');

// 直接输出CSV文件内容
echo $fileContent;

2.4 示例

下面是一个完整的导出CSV文件的示例，该示例将用户信息保存为CSV文件并输出到浏览器。复制代码并保存成php文件，在浏览器中运行即可下载或查看生成的CSV文件。

$data = [
    ['username', 'email'], // 表头
    ['张三', 'zhangsan@example.com'],
    ['李四', 'lisi@example.com'],
    ['王五', 'wangwu@example.com'],
];

$fileContent = '';
foreach ($data as $row) {
    $fileContent .= '"' . implode('","', $row) . '"' . "\n";
}

// 设置HTTP响应头，告诉浏览器文件类型是CSV格式
header('Content-Type: application/csv');
header('Content-Disposition: attachment; filename="user.csv";');

// 直接输出CSV文件内容
echo $fileContent;

3. 导入CSV文件

3.1 上传CSV文件

首先，我们需要让用户上传CSV文件。我们可以使用HTML表单和PHP的文件上传函数来实现。

<form action="import.php" method="post" enctype="multipart/form-data">
    <input type="file" name="csv_file"><br>
    <input type="submit" name="submit" value="导入">
</form>

在上面的表单中，enctype="multipart/form-data"表示表单要上传文件，input type="file"表示选择上传的文件，input type="submit"表示提交表单。

3.2 读取CSV文件内容

读取CSV文件内容需要使用PHP的文件处理和字符串函数。我们可以使用fgetcsv函数逐行读取CSV文件，并将每一行数据转换成数组。例如：

if (isset($_FILES['csv_file'])) {
    $file = $_FILES['csv_file']['tmp_name'];
    if (($handle = fopen($file, "r")) !== FALSE) {
        while (($data = fgetcsv($handle, 1000, ",")) !== FALSE) {
            // 处理每一行数据
        }
        fclose($handle);
    }
}

在上面的代码中，fopen函数打开CSV文件，fgetcsv函数逐行读取CSV文件的内容，fclose函数关闭CSV文件。

3.3 示例

下面是一个完整的导入CSV文件的示例，该示例将上传的CSV文件中每一行数据转换成数组，然后输出到页面上。复制代码并保存成php文件，在浏览器中运行即可上传CSV文件并查看文件内容。

if (isset($_FILES['csv_file'])) {
    $file = $_FILES['csv_file']['tmp_name'];
    if (($handle = fopen($file, "r")) !== FALSE) {
        while (($data = fgetcsv($handle, 1000, ",")) !== FALSE) {
            // 处理每一行数据
            var_dump($data);
        }
        fclose($handle);
    }
}
?>

<form action="import.php" method="post" enctype="multipart/form-data">
    <input type="file" name="csv_file"><br>
    <input type="submit" name="submit" value="导入">
</form>

以上就是完整的PHP导入导出CSV文件攻略。