What is CpChart?

A project bringing Composer support and some basic PHP 5 standards to pChart 2.0 library. The aim is to allow pChart integration into modern frameworks like Symfony2.

What was done:

Made a full port of the library's functionality.
Defined and added namespaces to all classes.
Replaced all 'exit()' / 'die()' commands with 'throw' statements to allow a degree of error control.
Reorganized files a bit and refactored code for better readability. Also, basic annotations were added to functions.
Added a factory service for loading the classes.
Moved all constants to a single file 'src/Resources/data/constants.php'. This file is required for the library to function. It is now loaded via Composer.

Installation:

GitHub

Packagist

For composer installation, add:

"require": {

"szymach/c-pchart": "1.*"

},

to your composer.json file and update your dependencies. After that, all classes are available under "CpChart\Classes" namespace or "CpChart\Services" for the factory.

Usage:

The main difference is that you can either load the class via the 'use' statement or use the provided factory. An example below.

require __DIR__.'/../vendor/autoload.php';

use CpChart\Services\pChartFactory;

try {
    // create a factory class - it will load necessary files automatically,
    // otherwise you will need to add them on your own
    $factory = new pChartFactory();
    
    // create and populate the pData class
    $myData = $factory->newData(array(VOID, 3, 4, 3, 5), "Serie1");

    // create the image and set the data
    $myPicture = $factory->newImage(700, 230, $myData);
    $myPicture->setGraphArea(60, 40, 670, 190);
    $myPicture->setFontProperties(
        array(
            "FontName" => "Forgotte.ttf",
            "FontSize" => 11
        )
    );
    
    // creating a pie chart - notice that you specify the type of chart, not class name.
    // not all charts need to be created through this method (ex. the bar chart),
    // some are created via the pImage class (check the documentation before drawing).
    $pieChart = $factory->newChart("pie", $myPicture, $myData);

    // do the drawing
    $myPicture->drawScale();
    $myPicture->drawSplineChart();   
    $myPicture->Stroke();

} catch (\Exception $ex) {
    echo 'There was an error: '.$ex->getMessage();
}

Basically, it should work as defined in the pChart 2.0 documentation with added support for try/catch functionality. The factory class has methods to load all types of classes present in the pChart library.

IMPORTANT! If you want to use any of the fonts or palletes files, provide only the name of the actual file, do not add the 'fonts' or 'palettes' folder to the string given into the function. If you want to load them from a different directory than the default, you need to add the full path to the file (ex. DIR.'/folder/to/my/palletes).