使用PHP_XLSXWriter代替PHPExcel 10W+資料秒級匯出
長數字匯出後顯示科學計數法的問題? 在該欄位前拼一個空格就可以解決了。
以下為轉載原文。
二者有何區別?
PHPExcel 是一個處理Excel,CVS檔案的開源框架,它基於微軟的OpenXML標準和PHP語言。可以使用它來讀取、寫入不同格式的電子表格,這也是PHP至今最通用的Excel處理工具,但是它有一個非常致命的缺點: 特別佔記憶體,對大批量的表格資料幾乎會讓人累覺不愛,處理速度非常慢,但是它功能非常豐富,API非常多,所以在匯出複雜格式的Excel表格時,你往往不得不使用它,真是讓人又愛又恨。
不幸的是,PHPExcel官方已不再維護了這個專案了,官方團隊在github上又起了一個新專案,叫PhpSpreadsheet,新專案使用了大量的php新特性,比如名稱空間,PSR標準,效能也比PHPExcel高了不少,不過該專案至今(2017-07-12)還是開發狀態,最小穩定版還沒出來,估計bug會比較多,所以並不建議使用,下圖是專案遷移說明:
相比於PHPExcel,PHP_XLSXWriter是一個小而強悍的Excel讀寫外掛,它並沒有PHPExcel功能豐富,很多高階操作比如凍結表頭,並不具備,但是它匯出速度非常快,非常適合於資料量特別大,報表格式不是很複雜的匯出需求,下圖是官方的速度和記憶體測試:
PHP_XLSXWriter 如何使用?
下載
這是 PHP_XLSXWriter的github地址,你可以點選下載把它下載下來。解壓之後你可以看到,它的核心檔案只有一個: xlswriter.class.php,examples目錄為程式碼樣例目錄,裡面有很多例子你可以參考。
使用
對於日常中絕大部分的報表需求,PHP_XLSXWriter 是可以勝任的,下面通過一個例子來熟悉一下API的使用。
假設我們要匯出下圖中的報表,並通過瀏覽器實現下載:
程式碼實現:
//writer 類
$writer = new XLSXWriter();
//檔名
$filename = "example.xlsx";
//設定 header,用於瀏覽器下載
header('Content-disposition: attachment; filename="'.XLSXWriter::sanitize_filename($filename).'"');
header("Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" );
header('Content-Transfer-Encoding: binary');
header('Cache-Control: must-revalidate');
header('Pragma: public');
//匯出的資料
$string = array (
0 =>
array (
'payc_bill_time' => '2017-07-12 16:40:44',
'payt_received_date' => '2017-07-12',
'ci_name' => '租金',
'payt_num' => 'YRZB(2012)A0047',
'payt_scsr_name' => '李巧紅',
'payt_received' => '300.00',
'paytd_type' => '現金',
'emp_name' => '鄭振標',
),
1 =>
array (
'payc_bill_time' => '2017-07-12 16:39:55',
'payt_received_date' => '2017-07-12',
'ci_name' => '租金',
'payt_num' => 'YRZB(2012)A0046',
'payt_scsr_name' => '22222',
'payt_received' => '45.00',
'paytd_type' => '現金',
'emp_name' => '鄭振標',
)
);
//每列的標題頭
$title = array (
0 => '開單時間',
1 => '收款時間',
2 => '開票專案',
3 => '票據編號',
4 => '客戶名稱',
5 => '實收金額',
6 => '收款方式',
7 => '收款人',
);
//工作簿名稱
$sheet1 = 'sheet1';
//對每列指定資料型別,對應單元格的資料型別
foreach ($title as $key => $item){
$col_style[] = $key ==5 ? 'price': 'string';
}
//設定列格式,suppress_row: 去掉會多出一行資料;widths: 指定每列寬度
$writer->writeSheetHeader($sheet1, $col_style, ['suppress_row'=>true,'widths'=>[20,20,20,20,20,20,20,20]] );
//寫入第二行的資料,順便指定樣式
$writer->writeSheetRow($sheet1, ['xxx財務報表'],
['height'=>32,'font-size'=>20,'font-style'=>'bold','halign'=>'center','valign'=>'center']);
/*設定標題頭,指定樣式*/
$styles1 = array( 'font'=>'宋體','font-size'=>10,'font-style'=>'bold', 'fill'=>'#eee',
'halign'=>'center', 'border'=>'left,right,top,bottom');
$writer->writeSheetRow($sheet1, $title,$styles1);
// 最後是資料,foreach寫入
foreach ($data as $value) {
foreach ($value as $item) { $temp[] = $item;}
$rows[] = $temp;
unset($temp);
}
$styles2 = ['height'=>16];
foreach($rows as $row){
$writer->writeSheetRow($sheet1, $row,$styles2);
}
//合併單元格,第一行的大標題需要合併單元格
$writer->markMergedCell($sheet1, $start_row=0, $start_col=0, $end_row=0, $end_col=7);
//輸出文件
$writer->writeToStdOut();
exit(0);
上面的每行程式碼都做了註釋,如果不懂得話可以去檢視一下example資料夾中的程式碼樣例以及官網主頁的文件,不過文件比較簡短;
跳坑指南:
自己在使用過程中也踩過一些坑,這裡列一下,希望對你有幫助:
檔名與類名不對應
在使用require或require_once時,這其實不是問題,但當使用自動載入時因為二者不對應就無法識別。你或許想把xlsxwriter.class.php檔案引入到你的專案中,並且加上名稱空間,以便於能實現自動載入。此時你需要做的是把檔名更改為類名XLSXWriter.class.php(這裡引入到TP中),比如我放到Component目錄下,那麼在該檔案中新增名稱空間namespace Component;,此時該檔案中還有個Zip類未引入名稱空間,需要新增use ZipArchive;
這些完成後,就可以在專案中其他地方使用了:
use Component;
$writer = new XLSXWriter();
如何設定列格式?
不同的列可能會需要顯示不同的格式,預設的都是文字格式,但有時候需要顯示為數字列,比便於使用excel中的函式,比如上表中的金額列,必須是兩位小數點,千分位,數字格式。
看上面的程式碼,數字格式其實是在writeSheetHeader方法中設定的,型別為price的那一列就是金額列,如果你需要其他格式,官網首頁上列出了常用的格式。
能不能單獨設定某個單元格的值?
這個目前並沒有實現,現在資料的寫入都是逐行寫入的,不支援這麼細的粒度,不過折中的做法是把不需要填充的單元格寫入null即可;
如果有什麼使用問題,可以在下面留言,一起探討使用方式:)