samchristy/piechart

A simple class for drawing pie charts with ImageMagick or GD in PHP.

v2.0.1 2014-01-25 22:44 UTC

This package is not auto-updated.

Last update: 2024-11-15 21:28:53 UTC


README

Latest Stable Version License Total Downloads Monthly Downloads

A reasonably efficient* class for drawing pie charts with ImageMagick or GD in PHP. Intended as a learning exercise for using the NetBeans IDE and the Xdebug profiler and debugger. The code is available under the GNU GPL v3.0, so feel free to use it with attribution. I recommend using the Imagick version, PieChartImagick over the GD version, PieChartGD.

Demonstration

Below is the code required to generate a pie chart and echo it to the client's browser. The example uses the method outputPNG() to tell the browser to render the image. Alternatively, the function forceDownloadPNG() can be used to instruct the browser to bring up the save dialog.

Documentation

View the documentation (generated with ApiGen).

Installation

Use Composer!

Example Usage

<?php
require 'vendor/autoload.php';  // Composer's autoloader.
use SamChristy\PieChart\PieChartGD;

$chart = new PieChartGD(600, 375);

$chart->setTitle('Browser Usage Statistics (January - April)');
// Method chaining coming soon!
$chart->addSlice('Google Chrome',   27, '#4A7EBB');
$chart->addSlice('Mozilla Firefox', 23, '#DA8137');
$chart->addSlice('Apple Safari',    11, '#9BBB59');
$chart->addSlice('Opera',            3, '#BE4B48');
$chart->addSlice('Other',            5, '#7D60A0');

$chart->draw();
$chart->outputPNG();

Output

Pie Chart

*This example took 150ms to execute on my laptop (i3-350M @ 2.27 GHz).

© Sam Christy 2013