使用PHP_XLSXWriter代替PHPExcel

两者有何区别?

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便可；

若是有什么使用问题，能够在下面留言，一块儿探讨使用方式:)