1.2. Installing

Unpack the PHPlot distribution into a convenient directory. Recent releases of PHPlot are available both as ZIP files, and as gzip-compressed TAR files. Use whichever format is more convenient for you. In the example below, the TAR format is unpacked.

$ tar -xvzf phplot-5.*.tar.gz
$ cd phplot-5.*

(Use the appropriate filename.) Check the distribution for README and/or INSTALL files which may contain newer instructions.

The main source file for PHPlot is phplot.php. There are some configuration settings you can make at the top of this file using a text editor. An example would be to change the default output format from PNG to GIF. For most installations, no changes are needed. But if you want to use TrueType fonts in your plot images, you can make it easier by changing the following two default values in phplot.php:


This should be set to the pathname of the directory where you keep TrueType fonts. Setting this here means scripts can find the fonts without calling SetTTFPath or including a full pathname to the font file.


This should be set to the filename of the TrueType font you want to use as a default for plots which enable TrueType fonts. You can specify just a filename without path, and the font will be found in the $ttf_path directory set above, or you can specify the full pathname of the font file. This provides a default for SetDefaultTTFont.

For example, you might change the settings in phplot.php to look like this:

  var $ttf_path = '/usr/local/share/fonts/truetype';
  var $default_ttfont = 'arial.ttf';

Installation of PHPlot simply involves copying three script files somewhere your PHP application scripts will be able to find them. The scripts are: phplot.php, phplot_data.php, and rgb.inc.php. Make sure the protections on these files allow the web server to read them. For example:

$ chmod 644 *.php

Then, simply copy the three files into a directory where PHP scripts will be able to include them. The ideal place is a directory outside your web server document area, and on your PHP include path (that you noted above in the PHP Info report). You can add to the include path in the PHP configuration file; consult the PHP manual for details. For example, if /usr/local/share/php is on your PHP include path, you can install PHPlot with:

$ cp phplot.php phplot_data.php rgb.inc.php /usr/local/share/php