使用PHP_XLSXWriter代替PHPExcel

hlyrain 2019-06-21

二者有何区别?

PHPExcel 是一个处理Excel,CVS文件的开源框架,它基于微软的OpenXML标准和PHP语言。可以使用它来读取、写入不同格式的电子表格,这也是PHP至今最通用的Excel处理工具,但是它有一个非常致命的缺点: 特别占内存,对大批量的表格数据几乎会让人累觉不爱,处理速度非常慢,但是它功能非常丰富,API非常多,所以在导出复杂格式的Excel表格时,你往往不得不使用它,真是让人又爱又恨。

不幸的是,PHPExcel官方已不再维护了这个项目了,官方团队在github上又起了一个新项目,叫PhpSpreadsheet,新项目使用了大量的PHP新特性,比如命名空间,PSR标准,性能也比PHPExcel高了不少,不过该项目至今(2017-07-12)还是开发状态,最小稳定版还没出来,估计bug会比较多,所以并不建议使用,下图是项目迁移说明:

使用PHP_XLSXWriter代替PHPExcel

相比于PHPExcelPHP_XLSXWriter是一个小而强悍的Excel读写插件,它并没有PHPExcel功能丰富,很多高级操作比如冻结表头,并不具备,但是它导出速度非常快,非常适合于数据量特别大,报表格式不是很复杂的导出需求,下图是官方的速度和内存测试:
使用PHP_XLSXWriter代替PHPExcel

PHP_XLSXWriter 如何使用?

下载

这是 PHP_XLSXWritergithub地址,你可以点击下载把它下载下来。解压之后你可以看到,它的核心文件只有一个: xlswriter.class.phpexamples目录为代码样例目录,里面有很多例子你可以参考。
使用PHP_XLSXWriter代替PHPExcel

使用

对于日常中绝大部分的报表需求,PHP_XLSXWriter 是可以胜任的,下面通过一个例子来熟悉一下API的使用。

假设我们要导出下图中的报表,并通过浏览器实现下载:

使用PHP_XLSXWriter代替PHPExcel

代码实现:

//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文件夹中的代码样例以及官网主页的文档,不过文档比较简短;

跳坑指南:

自己在使用过程中也踩过一些坑,这里列一下,希望对你有帮助:

文件名与类名不对应

在使用requirerequire_once时,这其实不是问题,但当使用自动加载时因为二者不对应就无法识别。你或许想把xlsxwriter.class.php文件引入到你的项目中,并且加上命名空间,以便于能实现自动加载。此时你需要做的是把文件名更改为类名xlsxwriter.class.php(这里引入到TP中),比如我放到Component目录下,那么在该文件中添加命名空间namespace Component;,此时该文件中还有个Zip类未引入命名空间,需要添加use ZipArchive;

这些完成后,就可以在项目中其他地方使用了:

use Component;
$writer = new XLSXWriter();

如何设置列格式?

不同的列可能会需要显示不同的格式,默认的都是文本格式,但有时候需要显示为数字列,比便于使用excel中的函数,比如上表中的金额列,必须是两位小数点,千分位,数字格式。

看上面的代码,数字格式其实是在writeSheetHeader方法中设置的,类型为price的那一列就是金额列,如果你需要其他格式,官网首页上列出了常用的格式。

能不能单独设置某个单元格的值?

这个目前并没有实现,现在数据的写入都是逐行写入的,不支持这么细的粒度,不过折中的做法是把不需要填充的单元格写入null即可;

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

相关推荐