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

如果有什么使用问题，可以在下面留言，一起探讨使用方式:)