4.10　JpGraph——由数字数据动态生成图表

在科学报告、论文中经常要做各种图表，有使用专用软件（如mgrahp等）完成绘图，也有直接使用Excel等办公软件来绘图。还有有在线股票交易，在外汇交易（FX）经验的朋友，会接触过适时变动的股价变化图与外汇变动图。其实这些图都是由程序动态制成的。

本节将介绍使用一种非常有用的免费程序库JpGraph，在PHP程序中实现绘图的应用。大家可能知道，PHP已经提供了GD2程序库可以用来绘制各种图形的，但是，使用GD2的图形函数绘图时，必须自己去定义坐标，并且要自己开发算法去实现复杂的图形。要画出一张满意的图表不是那么简单的事。而使用本节介绍的JpGraph程序库，根本不用考虑那么复杂的坐标，只用必需的数据传给专用的图形对象，就能生成你想要的图形。从图形设定到整体外观的设定，最后的图形输出的过程是固定的，很容易在需要生成的不同图形间切换。

本例要点

正如前面介绍的一样，使用JpGraph作图非常简单。只用将必要的数据以数组的形式传过来，绘图的工作交给JpGraph来完成就行。在下载的压缩文档中，有各种图形生成方法的介绍，可以按照介绍的方法，尝试生成各种各样的图形。

另外，JpGraph的下载模块中提供了超过250种应用实例，建议你实际测试一下这些实例，你会得到意想不到的收获。只有实际动手操作，才能更快更好地掌握它的应用。

目录结构

本例代码

使用<img/>输出生成的图形。

chart.php是输出生成图片的PHP脚本。记住，PHP脚本不仅可以在<a><form>中调用，也可以在<img>等对中调用，学会这些特殊的用法会增加程序的灵活性。

包含生成图形时必需的库。

设定图形的绘图大小（500×400像素）、背景、标题。在使用中文的情况下，事先设置字型、字体、字号。字体设置为FF_BIG5，中文的情况下，还可以设为FF_SIMSUN，FF_CHINESE。字型设为FS_NORMAL，字号为14号。

读入还有图形目标数据的文本文件data.txt，项目与值分别放在数组$legend和$data中。

数组$data的值生成三维图形。

分别设置图例，大小（0至0.5），中心位置。

将设定完成的PiePlot3D对象追加到PieGraph类中，进行图形输出。

补充

本例注意事项

本节使用的JpGraph是外部库。使用时，需要下载必要的库，并进行相关设定。

JpGraph的代码已经收录在随书附的光盘中了，JpGraph不断地在进行版本升级，请注意保持最新的版本。

GD2库的有效化

JpGraph库内部使用了GD2程序库。因此在使用JpGraph时，必须事先让GD2有效。如果你按照第1章介绍的步骤进行环境配置的话，那么GD2已经有效了，不需要额外的特别步骤。

下载/配置JpGraph

从http://www.aditus.nu/jpgraph/jpdownload.php下载最新的JpGraph代码。解压缩下载的JpGraph-XXX.tar.bz2（XXX为版本号）后，将目录下的“src”文件夹改名为“jpgraph”，并复制到PHP的include_path的目录下（Windows环境默认在“C:\php\includes\”，Linux环境默认在“/usr/local/lip/php/”目录中）。

中文支持

要在JpGraph中使用中文，必须设置Font的文件夹。Windows环境时，Font的文件夹为“c:\windows\fonts”，Linux环境为“/usr/share/fonts/truetype/”，如果Linux缺少Fonts文件，可以从http://corefonts.sourceforge.net/网站下载。

最新的JpGraph版本中以及兼顾了对多字节文字（中文、日文）的支持，以上的设置可以省略。

JpGraph的使用手册

这里使用的只是JpGraph的一部分功能，在“本例要点”中介绍过，JpGraph是一个提供各种高级绘图功能的程序库。只用改变对应的类，就可以绘出各种各样的图形。对JpGraph所有的功能感兴趣的朋友可以参照下述官方网站上的JpGraph使用手册：

http://www.aditus.nu/jpgraph/。