使用 PHP fputcsv 函數導出 CSV 文件

CSV（Comma Separated Values）即逗號分隔值，是一種常用的文件格式，常用於將數據從一個程序導出到另一個程序中。在 PHP 中，我們可以使用 fputcsv 函數將數組數據導出為 CSV 文件格式。

一、選擇要導出的數據

在開始編寫導出 CSV 文件的代碼前，我們需要確定要導出的數據。一般來說，我們需要從資料庫中查詢出需要導出的數據，並將其存儲為數組。在本例中，我們將以一個示例資料庫表為例。

CREATE TABLE `users` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(255) NOT NULL,
  `email` varchar(255) NOT NULL,
  `phone` varchar(255) NOT NULL,
  PRIMARY KEY (`id`)
);

INSERT INTO `users` (`name`, `email`, `phone`) VALUES
('John Doe', 'john@example.com', '123456789'),
('Jane Smith', 'jane@example.com', '987654321');

我們可以使用以下代碼從資料庫中查詢出需要導出的數據，並將其存儲為數組：

// 連接資料庫
$db = new mysqli('localhost', 'username', 'password', 'database');

// 查詢需要導出的數據
$result = $db->query("SELECT * FROM users");
$data = array();
while ($row = $result->fetch_assoc()) {
    $data[] = $row;
}

二、導出 CSV 文件

在從資料庫中查詢出需要導出的數據並將其存儲為數組之後，我們可以開始編寫代碼來將這些數據導出為 CSV 文件。

我們將使用 fputcsv 函數將數據寫入 CSV 文件中。fputcsv 函數將數組作為參數，並將其轉換為逗號分隔的字元串。然後，它將字元串寫入文件中。

以下是一個完整的示例代碼，該代碼將查詢出資料庫表中的所有數據，並將其導出為 CSV 文件：

// 連接資料庫
$db = new mysqli('localhost', 'username', 'password', 'database');

// 查詢需要導出的數據
$result = $db->query("SELECT * FROM users");
$data = array();
while ($row = $result->fetch_assoc()) {
    $data[] = $row;
}

// 導出 CSV 文件
$filename = 'users.csv';

// 打開文件句柄
$handle = fopen($filename, 'w');

// 將表頭寫入文件
fputcsv($handle, array_keys($data[0]));

// 將數據寫入文件
foreach ($data as $row) {
    fputcsv($handle, $row);
}

// 關閉文件句柄
fclose($handle);

// 文件下載
header('Content-Type: application/csv');
header('Content-Disposition: attachment; filename="' . $filename . '";');
readfile($filename);

在上面的代碼中，我們首先將數據查詢出來，並存儲為 $data 數組，然後將文件名設置為 users.csv。

接著，我們使用 fopen 函數打開文件句柄，並使用 fputcsv 函數寫入表頭（數組的鍵值）。

使用 foreach 循環，將每一行數據寫入文件中。在每一次寫入時，使用 fputcsv 函數將數據轉換為 CSV 格式，並寫入文件。

最後，我們使用 fclose 函數關閉文件句柄，並使用 header 和 readfile 函數將文件下載到本地。

三、導出中文字符集 CSV 文件

在導出 CSV 文件時，如果數據中包含中文字符集，我們需要對字元編碼進行特殊處理。

首先，我們需要將字元編碼從默認的 ANSI 編碼轉換為 UTF-8 編碼。我們可以使用以下代碼來轉換編碼：

foreach ($data as &$row) {
    foreach ($row as &$cell) {
        $cell = iconv('GB2312', 'UTF-8', $cell);
    }
}
unset($row, $cell);

這段代碼使用 iconv 函數將 GB2312 編碼的字元轉換為 UTF-8 編碼，其中 $data 是從資料庫中查詢出的數據數組。

然後，我們需要將編碼後的數據導出為 CSV 文件。導出過程與前面相同，只需在 fputcsv 函數前加上添加 BOM（Byte Order Mark）頭即可：

// 打開文件句柄
$handle = fopen($filename, 'w');

// 添加 BOM 頭
fwrite($handle, "\xEF\xBB\xBF");

// 將表頭寫入文件
fputcsv($handle, array_keys($data[0]));

// 將數據寫入文件
foreach ($data as $row) {
    fputcsv($handle, $row);
}

// 關閉文件句柄
fclose($handle);

// 文件下載
header('Content-Type: application/csv');
header('Content-Disposition: attachment; filename="' . $filename . '";');
readfile($filename);

在上面的代碼中，我們使用 fwrite 函數在文件最前面添加 BOM 頭，該頭部告訴程序文件使用 UTF-8 編碼。然後，我們使用 fputcsv 函數將表頭和數據寫入文件中，關閉文件句柄後將文件下載到本地。

四、總結

本文詳細介紹了使用 PHP 的 fputcsv 函數導出 CSV 文件的方法。首先，我們從資料庫中查詢出需要導出的數據並將其存儲為數組。然後，我們使用 fputcsv 函數將數據導出為 CSV 文件，並將其下載到本地。最後，我們講述了如何導出中文字符集數據。