1. 程式人生 > >使用PHP_XLSXWriter代替PHPExcel 10W+資料秒級匯出

使用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即可;

如果有什麼使用問題,可以在下面留言,一起探討使用方式:)