jpgraph缓存系统使用说明

在之前的php jpgraph教程中，有提到过使用jpgraph在生成大量图表时负担是非常重的，为了减轻WEB服务器上使用jpgraph的负载一般有两种方法：提供专门的jpgraph服务器来进行图表生成；或者使用合理的缓存机制来缓解压力。对于大部分PHP开发者来说利用缓存机制减轻jpgraph负载是最实用的方法。jpgraph类库支持两种显著提高性能的方法，即使用本教程所描述的内建缓存系统以及使用PHP加速器NuSphere PHP加速器。下图给出了jpgraph类库中缓存系统的概述：

　　启用jpgraph类库缓存系统

　　启用或关闭jpgraph缓存系统是通过jpg-config.php中的三个定义进行控制的

　　以上三个开关中USE_CACHE是开启缓存系统的主开关，必须设置为true。

　　第二个开关READ_CACHE很少需要改变。第二个开关，基本上告诉JpGraph是否应该不断查询高速缓存中的内容。设置为false，主开关设置为true，将在缓存中总是产生一个新的更新的图像文件，这个新图像将发送回浏览器。

　　第三个定义不是真正的开关而是一个指定目录以告知jpgraph类库使用什么目录作为缓存目录(即缓存图像存储的地方)，缓存目录(CACHE_DIR)可以设置为任意目录但是需要牢记的是缓存目录对于运行的PHP程序必须可读写。

　　jpgraph缓存目录提示：给定的目录名必须是一个绝对目录路径而不是一个文件的相对根目录。

　　缓存文件的权限限制

　　注：本节仅适用于Unix的衍生系统其具有组和文件所有权的概念。

　　有两个额外的设置将允许控制组合文件的权限设置

　　CACHE_FILE_GROUP指定哪个组应设置缓存图像文件。如果为空，则组将和运行的PHP程序相同。CACHE_FILE_MOD指定图像文件的文件权限。如果为空，PHP使用的默认权限将被设置在文件上。

　　当PHP运行在命令行（使用PHP的CLI版本）文件的权限和组通常会设置运行PHP suer之一。请记住，一般的普通用户不允许更改组“WWW”（默认Apache2的目录）。

　　在程序中使用缓存

　　jpgraph类库启用缓存时主要有以下原则

　　图表程序第一次被调用的时候与往常一样，脚本将会运行到最后将图片返回至游览器。但是，如果启用缓存，JpGraph将自动获得存储在缓存目录中生成的图像的副本。

　　当图表脚本下一次执行时检查看看是否在缓存目录中已经生成这个图表脚本对应的图片。

　　如果存储在缓存目录中的图片是可用的，jpgraph类库将检查图片的新旧程度。如果图片的新旧度超过规定，图表脚本将像往常一样产生最新的图片并存储在缓存目录中。

　　如果在缓存目录中的图片是当前的，则将不会执行脚本的剩余部分，而是直接读取图片并送至游览器。

　　通过上面的描述可以看到需要指定几个参数，比如，存储图片时需要使用什么名称，超过多少时间时图片被认定已陈旧。

　　第一个参数，文件名，可以手动指定或jpgraph类库可以基于图表脚本的名称自动创建一个文件名。

　　所有这些参数都是在初始化一个图表实例时通过调用Graph()指定的。下面的实例中将使用jpgraph类库自动定义的缓存文件名，同时设定缓存中的图片只有60分钟的有效期，超过将需要更新。

　　这意味着当程序被再次调用时，在60分钟内，将在初始化函数Graph()调用后直接返回图片而不需要执行脚本中的其他代码。对于基本的缓存使用方法这些是必须的，启用缓存并提供文件名和超时值，其余都通过类库来处理。

　　jpgraph缓存使用提示：如果你想“永远”不超时，你可以指定0（或保留参数为空）的超时值。要重新生成图像，你将不得不手动从缓存中删除的图像文件。

　　人工控制缓存图片

　　这些实用功能在3.0.5版本中已添加、在之前的版本中也是可能实现的，但需要更多的代码。如果你需要这个功能，请更新到最新版本。

　　人工需要做两部分

　　1、检查缓存中是否存在缓存图片并且是有效时间内的。

　　2、如果是，则将图片文件送至游览器。如果缓存文件已超时，那么就需要像往常一样构造图表并自动将图片存储在缓存中。下面的实例说明了这种情况

　　使用缓存客户端CSIM，详细的将会在后续介绍，这里只要了解一下即可

　　您还可以使用图像缓存系统（CSIM）。缓存系统接口在这种情况下稍有不同，因为缓存需要存储缓存图像和缓存的图像映射。

　　由于增加了复杂性，CSIM脚本不发送回图像，而是一个预先格式化的HTML页面。与非CSIM缓存主要有两个主要区别：

　　1、缓存版本将不会存储在之前定义的缓存目录中。其使用不同的缓存目录。

　　2、脚本想要与CSIM一起使用缓存系统需要调用格外的方法，CheckCSIMCache()来检查缓存。

　　缓存客户端CSIM使用提示：当使用CSIM时在脚本最后必须调用Graph::StrokeCSIM()方法而不是Graph::Stroke()

　　使用CSIM缓存你需要调用Graph::CheckCSIMCache()。由于使用非CSIM缓存时，需要提供缓存文件名和可选项超时时间，如果没有指定默认超时时间是60分钟。

　　使用CSIM不发送图片至游览器的理由是其发送一个HTML页面，其中包换了图像映射的坐标和”” 的标签，其将引用图片脚本，但是如果缓存中有图片则将引用静态图片。

　　根据jpgraph类库的安装CSIMCACHE_DIR的定义也有要求。其必须是普通HTTP/PHP程序可以访问的一个目录，默认情况下，如果不指定，则将创建一个csimcache目录。默认设置的缺点是目录必须也是PHP程序可写的目录，最佳的办法是重新使用标准缓存相同的目录。但是也需要PHP和HTTP服务器通过htdocs root访问。

　　CheckCSIMCache()方法将会检查现有缓存版本的缓存，如果发现则将返回并停止脚本的执行。所以这个调用必须在创建图表实例$graph = Graph($width,$height)之后首先调用。

　　使用CSIM和缓存的程序脚本的总体结构如下

　　注意不需要传递任何参数给最后的调用StrokeCSIM()函数。CSIM缓存通过在缓存目录中存储两个文件来工作，一个文件是图片，另一个文件对应于图片映射的HTML文件。HTML文件引用静态图片文件。