使用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
即可;
如果有什么使用问题,可以在下面留言,一起探讨使用方式:)