phpexcel图形图表(一)入门

PHPExcel - Excel的PHP处理引擎

PHPExcel 提供了一系列的 PHP语言 类，让你可以轻松地读写操作以下格式的文件：.xls/.xlsx/.csv/.ods/Gnumeric/PDF/HTML...
主要功能包括：设置文件的meta信息，多工作表，定制字体和样式，边框和填充，图片，计算公式，转换文件类型等等

之前我只是用到了导出数据到列表格式的Excel文件，这次需要实现的目标是：JSON->phpexcel->excel+chart(line/pie/etc...)

本系列《phpexcel图形图表》文章梗概如下：

phpexcel图形图表(一)-入门----------------介绍PHPExcel类库和画图的基本步骤
phpexcel图形图表(二)-图形----------------以最常用的line/pie/bar/radar图形为例作图，并对比和分析4种API
phpexcel图形图表(三)-进阶----------------让图形美化，完成一些高级的效果
phpexcel图形图表(三)-高级----------------PHPExcel能完成的图表相关的高级功能

原创文章，转载请注明出处：http://www.cnblogs.com/phpgcs

本篇文章梗概：
1. 下载并研究PHPExcel仓库
2. PHPExcel画图和普通数据处理的区别
3. 注意事项总结

首先最好是把PHPExcel的项目下载到本地来研究

git clone git@github.com:PHPOffice/PHPExcel.git

请先仔细阅读README.md说明文档，因为里面包含了很重要的版本信息，尤其是读写Excel文档的版本范围信息

### Reading
 * BIFF 5-8 (.xls) Excel 95 and above
 * Office Open XML (.xlsx) Excel 2007 and above
 * SpreadsheetML (.xml) Excel 2003
 * Open Document Format/OASIS (.ods)
 * Gnumeric
 * HTML
 * SYLK
 * CSV
 
### Writing
 * BIFF 8 (.xls) Excel 95 and above
 * Office Open XML (.xlsx) Excel 2007 and above
 * HTML
 * CSV
 * PDF (using either the tcPDF, DomPDF or mPDF libraries, which need to be installed separately)
 
## Requirements
 * PHP version 5.2.0 or higher
 * PHP extension php_zip enabled (required if you need PHPExcel to handle .xlsx .ods or .gnumeric files)
 * PHP extension php_xml enabled
 * PHP extension php_gd2 enabled (optional, but required for exact column width autocalculation)

　　

进入Examples文件夹，OhMygod,可以完成这么多的功能呀

01pharSimple.php
01simple-download-pdf.php
01simple-download-xls.php
01simple-download-xlsx.php
01simplePCLZip.php
01simple.php
02types.php
02types-xls.php
03formulas.php
04printing.php
05featuredemo.inc.php
05featuredemo.php
06largescale.php
06largescale-with-cellcaching.php
06largescale-with-cellcaching-sqlite3.php
06largescale-with-cellcaching-sqlite.php
06largescale-xls.php
07readerPCLZip.php
07reader.php
08conditionalformatting2.php
08conditionalformatting.php
09pagebreaks.php
10autofilter.php
10autofilter-selection-1.php
10autofilter-selection-2.php
10autofilter-selection-display.php
11documentsecurity.php
11documentsecurity-xls.php
12cellProtection.php
13calculation.php
14excel5.php
15datavalidation.php
15datavalidation-xls.php
16csv.php
17html.php
18extendedcalculation.php
19namedrange.php
20readexcel5.php
21pdf.php
22heavilyformatted.php
23sharedstyles.php
24readfilter.php
25inmemoryimage.php
26utf8.php
27imagesexcel5.php
28iterator.php
29advancedvaluebinder.php
30template.php
31docproperties_write.php
31docproperties_write-xls.php
32chartreadwrite.php
33chartcreate-area.php
33chartcreate-bar.php
33chartcreate-bar-stacked.php
33chartcreate-column-2.php
33chartcreate-column.php
33chartcreate-composite.php
33chartcreate-line.php
33chartcreate-multiple-charts.php
33chartcreate-pie.php
33chartcreate-radar.php
33chartcreate-scatter.php
33chartcreate-stock.php
34chartupdate.php
35chartrender.php
36chartreadwriteHTML.php
36chartreadwritePDF.php
37page_layout_view.php
38cloneWorksheet.php
40duplicateStyle.php
Excel2003XMLReader.php
Excel2003XMLTest.xml
.gitignore
GnumericReader.php
GnumericTest.gnumeric
images/
list
.~lock.33chartcreate-line.xlsx#
OOCalcReaderPCLZip.php
OOCalcReader.php
OOCalcTest.ods
Quadratic2.php
Quadratic.php
Quadratic.xlsx
runall.php
SylkReader.php
SylkTest.slk
templates/
XMLReader.php
XMLTest.xml

　

好吧，这次的任务是chart，就先从 line chart 入手，相关的文件只有一个 ***line.php

我们先直接运行一把：

liuyuan@ebuinfo:/var/www/projects/PHPExcel/Examples$ php 33chartcreate-line.php
07:13:22 Write to Excel2007 format
07:13:23 File written to 33chartcreate-line.xlsx
07:13:23 Peak memory usage: 8.75 MB
07:13:23 Done writing file
File has been created in /var/www/projects/PHPExcel/Examples

　　

Wow，生成了一个Excel文件哦，赶紧打开

这也太简单了吧，赶紧看看源码（附带说明）

<?php
 
/** 开启各种PHP Error Report机制 */
error_reporting(E_ALL);
ini_set('display_errors', TRUE);
ini_set('display_startup_errors', TRUE);
date_default_timezone_set('Europe/London');
 
define('EOL',(PHP_SAPI == 'cli') ? PHP_EOL : '<br />');
 
date_default_timezone_set('Europe/London');
 
/** 引入最重要的PHPExcel类库的入口文件 */
require_once dirname(__FILE__) . '/../Classes/PHPExcel.php';
 
/* 创建PHPExcel对象 */
$objPHPExcel = new PHPExcel();
 
/* 其实最常用的操作是Excel的工作表sheet，因此我们取活动sheet对象 */
$objWorksheet = $objPHPExcel->getActiveSheet();
 
/* 画一个line图的源数据是一个2维数组，这样可以画多条line，即多个series */
$objWorksheet->fromArray(
	array(
		array('',	2010,	2011,	2012),
		array('Q1',   12,   15,		21),
		array('Q2',   56,   73,		86),
		array('Q3',   52,   61,		69),
		array('Q4',   30,   32,		0),
	)
);
 
/* 这里有一个重要的类PHPExcel_Chart_DataSeriesValues,后面多次用到，它有几个参数
 *
 * 数据类型  Datatype
 * 指定单元格  Cell reference for data
 * 格式代码 Format Code
 * 本系列数据中元素个数  Number of datapoints in series
 * Data values
 * Data
*/
 
// 设置每一个data series 数据系列的名称
$dataseriesLabels = array(
	new PHPExcel_Chart_DataSeriesValues('String', 'Worksheet!$B$1', NULL, 1),	//	2010
	new PHPExcel_Chart_DataSeriesValues('String', 'Worksheet!$C$1', NULL, 1),	//	2011
	new PHPExcel_Chart_DataSeriesValues('String', 'Worksheet!$D$1', NULL, 1),	//	2012
);
//	设置X轴Tick数据(X轴每一个刻度值)
$xAxisTickValues = array(
	new PHPExcel_Chart_DataSeriesValues('String', 'Worksheet!$A$2:$A$5', NULL, 4),	//	Q1 to Q4
);
//	设置作图区域数据
$dataSeriesValues = array(
	new PHPExcel_Chart_DataSeriesValues('Number', 'Worksheet!$B$2:$B$5', NULL, 4),
	new PHPExcel_Chart_DataSeriesValues('Number', 'Worksheet!$C$2:$C$5', NULL, 4),
	new PHPExcel_Chart_DataSeriesValues('Number', 'Worksheet!$D$2:$D$5', NULL, 4),
);
 
//	构建数据系列 dataseries
$series = new PHPExcel_Chart_DataSeries(
	PHPExcel_Chart_DataSeries::TYPE_LINECHART,		// plotType
	PHPExcel_Chart_DataSeries::GROUPING_STACKED,	// plotGrouping
	range(0, count($dataSeriesValues)-1),			// plotOrder
	$dataseriesLabels,								// plotLabel
	$xAxisTickValues,								// plotCategory
	$dataSeriesValues								// plotValues
);
 
// 给数据系列分配一个做图区域
$plotarea = new PHPExcel_Chart_PlotArea(NULL, array($series));
// Set the chart legend
$legend = new PHPExcel_Chart_Legend(PHPExcel_Chart_Legend::POSITION_TOPRIGHT, NULL, false);
 
// 设置图形标题
$title = new PHPExcel_Chart_Title('Test Stacked Line Chart');
// 设置Y轴标签
$yAxisLabel = new PHPExcel_Chart_Title('Value ($k)');
 
// 创建图形
$chart = new PHPExcel_Chart(
	'chart1',		// name
	$title,			// title
	$legend,		// legend
	$plotarea,		// plotArea
	true,			// plotVisibleOnly
	0,				// displayBlanksAs
	NULL,			// xAxisLabel
	$yAxisLabel		// yAxisLabel
);
 
// 设置图形绘制区域
$chart->setTopLeftPosition('A7');
$chart->setBottomRightPosition('H20');
 
// 将图形添加到当前工作表
$objWorksheet->addChart($chart);
 
// Save Excel 2007 file
echo date('H:i:s') , " Write to Excel2007 format" , EOL;
$objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel2007');
// 打开做图开关
$objWriter->setIncludeCharts(TRUE);
$objWriter->save(str_replace('.php', '.xlsx', __FILE__));
echo date('H:i:s') , " File written to " , str_replace('.php', '.xlsx', pathinfo(__FILE__, PATHINFO_BASENAME)) , EOL;
 
// Echo memory peak usage
echo date('H:i:s') , " Peak memory usage: " , (memory_get_peak_usage(true) / 1024 / 1024) , " MB" , EOL;
 
// Echo done
echo date('H:i:s') , " Done writing file" , EOL;
echo 'File has been created in ' , getcwd() , EOL;

　　

总结一下：

1，引入PHPExcel
2，填充源数据到工作表上
	$objWorkSheet->fromArray($array);
	or
	$objWorkSheet->setCellValues('A1', 1);
3，设置dataseries
	PHPExcel_Chart_DataSeries::TYPE_LINECHART,
	PHPExcel_Chart_DataSeries::GROUPING_STACKED,
	range(0, count($dataSeriesValues）-1），
	$dataseriesLabels=>array(new PHPExcel_Chart_DataSeriesValues('String', 'Worksheet!$AB$1', NULL, 1)),
	$xAxisTickValues=>array(new PHPExcel_Chart_DataSeriesValues('String', 'Worksheet!$AA$2:$AA$21', NULL, 20),),
	$dataSeriesValues=>array(new PHPExcel_Chart_DataSeriesValues('Number', 'Worksheet!$AB$2:$AB$21', NULL, 20))
4，设置chart
	'chartTitle'=>'just a title',
	$title=>new PHPExcel_Chart_Title('新闻热点趋势'),
	$legend=>new PHPExcel_Chart_Legend(PHPExcel_Chart_Legend::POSITION_TOPRIGHT, NULL, false),
	$plotarea=>new PHPExcel_Chart_PlotArea(NULL, array($series)),
	'plotVisibleOnly'=>true,
	'displayBlanksAs'=>0,
	'xAxisLabel'=>NULL,
	'yAxisLabel'=>new PHPExcel_Chart_Title('报道量'),
5，设置chart位置
	$chart->setTopLeftPosition('A1');
	$chart->setBottomRightPosition('P20');
6，添加chart
    $objWorksheet->addChart($chart);
7，保存文件
    $objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel2007');
	$objWriter->setIncludeCharts(TRUE);
	$objWriter->save(str_replace('.php', '.xlsx', __FILE__));

　　

很简单吧，跟PHP导出普通数据对比，就是多了chart的各种设置

仔细想想，其实我们用PHPExcel API 这个设置的过程，跟我们直接在Excel中填充一个二维数组，然后插入图表的过程进行设置数据区域的过程是一样的

原创文章，转载请注明出处：http://www.cnblogs.com/phpgcs

最重要的2句话是：

普通数据：

$objWorkSheet->setCellValue('A1', 12345);

图表：我们要先将源数据放到工作表上（可以用setCellValue ，也可以用fromArray），然后做图的时候调用这些数据所在的位置

$xAxisTickValues = array(
        new PHPExcel_Chart_DataSeriesValues('String', '图表分析!$AE$2:$AE$30', NULL, 30),
);

　　

有几点需要注意的是：

1，保存文件的格式 xlsx 以及 PHPExcel_IOFactory 调用的是 'Excel2007' 而不能是 'Excel5'

$filename = date('Y-m-d', time()).'_'.md5(time()).'.xlsx';
$objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel2007');

　　

另外只要是有chart，千万不能少了2行代码：

$objWorksheet->addChart($chart4);
 
$objWriter->setIncludeCharts(TRUE);

　　

2，调试的时候，如果报错

Call to a member function cellExists() on a non-object /phpexcel/Classes/PHPExcel/Calculation.php on line 3241

一般都是 getCellValue()失败， 请参看那篇blog

3，PHPExcel_Chart_DataSeriesValues的第4个参数，是系列数据的个数，要等于确实存在的数据个数，如果开始不知道动态数据会填充几行，那就用变量，否则图形会有很多地方是无数据的状态，很不美观。

之所以这样，因为Excel作图本来就是根据你指定的数据区域作图的，如果你指定了空的区域，那图形上也会表现出来的。

$dataSeriesValues = array(
    new PHPExcel_Chart_DataSeriesValues('Number', 'Worksheet!$AB$2:$AB$21', NULL, 20),
 );

　　

最后研究下如何数据来源是JSON的情况，其实不就是JSON-->Array

$arraydata = json_decode($jsondata, true);
if($jsondata && $arraydata['status'] == 'success')
{
       $arraydata = $arraydata['series'];
       $newarraydata[] = array('日期', '报道量');
       foreach($arraydata as $k=>$v)
       {
              $newarraydata[] = array($k, $v);
         }
        $objPHPExcel->getActiveSheet()->setTitle('图表分析');
        $objWorksheet = $objPHPExcel->getActiveSheet();
        $objWorksheet->fromArray($newarraydata, NULL, 'AA1');
.....

　　

END，下一篇再写写几种常用的chart API

原创文章，转载请注明出处：http://www.cnblogs.com/phpgcs