使用PHP原生匯出Excel和CSV檔案

reggie發表於2021-07-22

PHP原生匯出Excel

匯出的原理其實就是通過設定Header頭告訴瀏覽器用excel的格式來解析讀取,然後通過生成HTML表格來輸出內容。對於單元格的合併其實就和操作HTML表格的合併是一樣的了,支援樣式的屬性和欄位,同時還可以操作 td 的樣式來控制單元格。

匯出虛擬碼如下:

/**
 * 匯出excel檔案
 *
 * @param string $excelFileName 匯出的檔名
 * @param array $title excel的標題列
 * @param array $data 匯出的資料
 */
public function exportExcel($excelFileName, $title, $data)
{
    $str = "<html xmlns:o=\"urn:schemas-microsoft-com:office:office\"\r\nxmlns:x=\"urn:schemas-microsoft-com:office:excel\"\r\nxmlns=\"http://www.w3.org/TR/REC-html40\">\r\n<head>\r\n<meta http-equiv=Content-Type content=\"text/html; charset=utf-8\">\r\n</head>\r\n<body>";
    $str .="<table border=1 align=center cellpadding=0 cellspacing=0>";
    // 拼接標題行
    $str .= '<tr style="height:25px;font-size:13px;font-weight: bold;">';
    foreach ($title as $key => $val) {
        $str .= '<td>'.$val.'</td>';
    }
    $str .= '</tr>';
    // 拼接資料
    foreach ($data as $key => $val) {
        $str .= '<tr style="text-align: left;height:25px;font-size:13px;">';
        foreach ($val as $v) {
            if (is_numeric($v) && $v > 100000000) {
                $str .= "<td style='vnd.ms-excel.numberformat:@'>".$v."</td>";
            } elseif (is_numeric($v) && preg_match('/^[0-9]+(\.[0-9]{2})+$/', $v)) {
                // 是兩位小數的保留2位顯示
                $str .= "<td style='vnd.ms-excel.numberformat:0.00'>".$v."</td>";
            } elseif (preg_match('/^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1]) (0[0-9]|1[0-9]|2[0-4]):(0[0-9]|[1-5][0-9]):(0[0-9]|[1-5][0-9])$/', $v)) {
                // 是日期
                $str .= "<td style='vnd.ms-excel.numberformat:yyyy-mm-dd\ hh\:mm\:ss'>".$v."</td>";
            } else {
                $str .= "<td>".$v."</td>";
            }
        }
        $str .= "</tr>\n";
    }
    $str .= "</table></body></html>";
    // 實現檔案下載
    header("Content-Type: application/vnd.ms-excel; name='excel'");
    header("Content-type: application/octet-stream");
    header("Content-Disposition: attachment; filename=" . $excelFileName);
    header("Cache-Control: must-revalidate, post-check=0, pre-check=0");
    header("Pragma: no-cache");
    header("Expires: 0");
    exit($str);
}

其中我簡單寫了些樣式和一些正則校驗,不用可以刪除。主要說一下一些單元格的格式化說明。

以上的匯出會有幾個常見的問題:

1.對於身份證號,手機號等過大的數字 顯示的時候會用科學計數法顯示。如果不介意字串顯示的話可以通過設定 td 的樣式來控制 style='vnd.ms-excel.numberformat:@' 這樣表示用文字的方式來顯示

2.對於數字如果需要保留小數位可以設定 style='vnd.ms-excel.numberformat:0.00' 需要保留幾位小數就寫幾個0,需要注意一點如果你傳入的值比保留的小數位多,那麼值會被四捨五入。比如傳入的是 87.98 而設定的保留小數位是 vnd.ms-excel.numberformat:0.0 那麼會顯示成 88.0

3.對於日期格式設定 style='vnd.ms-excel.numberformat:yyyy-mm-dd\ hh\:mm\:ss' 其中空格、冒號等都需要轉義。如果使用的是HTML裡的空格字元表輔助出來會有些不一樣,上面是常用的格式組合,可以自己做轉換。還有一些別的轉換 style='vnd.ms-excel.numberformat:\"Short Date\"' 這個會顯示成 2019/7/1; style='vnd.ms-excel.numberformat:\"Medium Date\"' 會顯示成 1-Jul-19

4.百分比顯示。 要顯示百分比的話 可以使用格式 style='vnd.ms-excel.numberformat:0%' 有一點需要注意顯示的時候會把你的值放大100倍。也就是說假如你想顯示成 2% 你傳遞進來的值需要是 0.02

5.千位分隔符。如果需要數字顯示帶千位分隔符可以設定 style='vnd.ms-excel.numberformat:#,###' 比如 123456 就會顯示成 123,456

常用的也就上面這些了 這裡還有個 常用列表 不過他使用的關鍵字是 mso-number-format 我嘗試了下 style 中使用 mso-number-formatvnd.ms-excel.numberformat 都可以。

PHP匯出CSV

CSV檔案其實是一種通用的檔案,有時也被叫做文字檔案。因此匯出的CSV資料包檔案不能設定單元格的樣式,而xls屬於二進位制的檔案需要使用Excel之類的工具才能開啟。如果沒有硬性要求匯出這種速度更快,我看阿里雲上的一些匯出都是CSV格式,但是我們這邊的需要非要excel檔案.

虛擬碼如下:

/**
 * 匯出CSV標準檔案
 *
 * @param string $fileName 匯出的檔名
 * @param array $title 標題列
 * @param array $data 匯出的資料
 */
function exportCsv($fileName, $title, $data)
{
    // 清空輸出流,防止有別的資訊
    ob_end_clean();
    // 開啟一個輸出流
    ob_start();
    // 設定header資訊
    header("Content-Type: text/csv");
    header("Content-Disposition:filename=". $fileName);
    // 開啟檔案流
    $fileHandle = fopen('php://output', 'w');
    //轉碼 防止亂碼
    fwrite($fileHandle, chr(0xEF).chr(0xBB).chr(0xBF));
    // 先把標題寫進去
    fputcsv($fileHandle, $title);
    $index = 0;
    foreach ($data as $item) {
        // 每2000條釋放一次資源
        if ($index == 2000) {
            $index = 0;
            ob_flush();
            flush();
        }
        $index++;
        fputcsv($fileHandle, $item);
    }
    // 釋放資源
    ob_flush();
    flush();
    ob_end_clean();
}
本作品採用《CC 協議》,轉載必須註明作者和本文連結
鐵甲依然在

相關文章