Академический Документы
Профессиональный Документы
Культура Документы
OVERVIEW:
CONTENTS:
REQUIREMENTS:
You need a recent version of PHP5, and you are advised to use the latest
stable release. This version of PHPlot has been tested with PHP-5.3.6 and
PHP-5.2.17 on Linux, and with PHP-5.3.6 on Windows XP. Note that the PHP
Group has dropped support for PHP-5.2.x. If you are still using PHP-5.2.x,
you should plan to upgrade as soon as you can. PHPlot testing with PHP-5.2.x
might not continue past this release.
If you want to display PHPlot charts on a web site, you need a PHP-enabled
web server. You can also use the PHP CLI interface without a web server.
PHPlot supports TrueType fonts, but does not include any TrueType font files.
If you want to use TrueType fonts on your plots, you need to have TrueType
support in GD, and some TrueType font files. (Your operating system most
likely includes TrueType fonts.) By default, PHPlot uses a simple font which
is built in to the GD library.
INSTALLATION:
Unpack the distribution. (If you are reading this file, you have probably
already done that.)
Installation of PHPlot simply involves copying two script files somewhere
your PHP application scripts will be able to find them. The scripts are:
phplot.php - The main script file
rgb.inc.php - Optional large color table
Make sure the permissions on these files allow the web server to read them.
The ideal place is a directory outside your web server document area,
and on your PHP include path. You can add to the include path in the PHP
configuration file; consult the PHP manual for details.
UPGRADING:
KNOWN ISSUES:
Here are some of the problems we know about in PHPlot. See the bug tracker
on the PHPlot project web site for more information.
PHP Issues:
PHP has many build-time and configuration options, and these can affect
the operation of PHPlot (as well as any other application or library). Here
are some known issues:
+ The Ubuntu Linux PHP GD package (php5-gd) was built to use the external
shared GD library, not the one bundled with PHP. This can result in small
differences in images, and some unsupported features (such as advanced
truecolor image operations). Also, although this Ubuntu GD library was
built with fontconfig support, PHP does not use it, so you still need to
specify TrueType fonts with their actual file names.
+ Some PHP installations may have a memory limit set too low to support
large images, especially truecolor images.
+ PHP-5.3.2 and PHP-5.2.13 have a bug in rendering TrueType fonts (TTF).
Avoid using these versions if you use TTF text in PHPlot.
If you think you found a problem with PHPlot, or want to ask questions or
provide feedback, please use the Help and Discussion forum at
http://sourceforge.net/projects/phplot/
If you are sure you have found a bug, you can report it on the Bug tracker
at the same web site. There is also a Features Request tracker.
TESTING:
You can test your installation by creating the following two files somewhere
in your web document area. First, the HTML file:
Second, in the same directory, the image file producing PHP script file.
Depending on where you installed phplot.php, you may need to specify a path
in the 'require' line below.
You should have received a copy of the GNU Lesser General Public
License along with this software; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA