README

Charts is a zero-dependency PHP library for generating SVG charts. It enables easy creation of SVG-based charts directly from PHP, with no additional dependencies required.

Features

Simple, intuitive API for chart creation
Lightweight, with no external dependencies
Supports various chart types: line charts, bar charts, stacked charts, boxplots, and mixed charts
Fully customizable and extendable
Outputs pure SVG, allowing for:
- Embedding in PDFs, view example PDF report

Installation

To get started, install the package via composer:

composer require lennyrouanet/charts

Usage Examples

Below are some examples of the types of charts you can create using this library. Click on the links to view the source code for each example.

Example Usage With mPDF
Simple Line Chart
Curved Line Chart
Step Line Chart
Area Line Chart
Bar Chart
Stacked Bar Chart
Grouped Bar Chart
Advanced Line Chart
Advanced Bar Chart
Mixed Chart
Negative Values Chart
Pie Chart

Usage

Creating a Chart

You can create different types of charts using the provided classes. Below are examples of how to create a simple bar chart and a line chart.

Simple Bar Chart

use Maantje\Charts\Bar\Bar;
use Maantje\Charts\Bar\Bars;
use Maantje\Charts\Chart;

$chart = new Chart(
    series: [
        new Bars(
            bars: [
                new Bar(name: 'Jan', value: 222301),
                new Bar(name: 'Feb', value: 189242),
                new Bar(name: 'Mar', value: 144922),
            ],
        ),
    ],
);

echo $chart->render();

Simple Line Chart

use Maantje\Charts\Chart;
use Maantje\Charts\Line\Line;
use Maantje\Charts\Line\Lines;
use Maantje\Charts\Line\Point;

$chart = new Chart(
    series: [
        new Lines(
            lines: [
                new Line(
                    points: [
                        new Point(x: 0, y: 0),
                        new Point(x: 100, y: 4),
                        new Point(x: 200, y: 12),
                        new Point(x: 300, y: 8),
                    ],
                ),
                new Line(
                    points: [
                        [0, 0],
                        [100, 4],
                        [200, 12],
                        [300, 8],
                    ],
                ),
            ],
        ),
    ],
);

echo $chart->render();

Simple Boxplot Chart

use Maantje\Charts\Boxplot\Boxplot;
use Maantje\Charts\Boxplot\Boxplots;
use Maantje\Charts\Chart;

$chart = new Chart(
    series: [
        new Boxplots(
            boxplots: [
                new Boxplot(name: 'Jan', values: [12, 30, 45, 60, 88]),
                new Boxplot(name: 'Feb', values: [20, 35, 50, 70, 95, 130, 4]),
            ],
        ),
    ],
);

echo $chart->render();

The values of a boxplot are given in order: min, Q1, median, Q3, max. Any value after the fifth is an outlier and is drawn as a point. The library does not compute quartiles: pass the five statistics already calculated.

Two things to keep in mind:

To draw boxplots on a secondary Y axis, pass the same yAxis name to Boxplots (it drives the axis range) and to each Boxplot (it drives the drawing), as with Bars and Bar.
The default Y axis starts at 0. For negative values, give the chart its own axis, e.g. yAxis: new YAxis.

Line over boxplots or bars

A regular Line places its points on the numeric X axis scale, so they do not line up with boxplots or bars, which sit in equal slots. Use a SlotLine instead: it takes one value per slot, in order, places each one at the centre of its slot and adds no scale to the X axis.

use Maantje\Charts\Line\Lines;
use Maantje\Charts\Line\SlotLine;

$chart = new Chart(
    series: [
        new Boxplots(boxplots: [/* three boxplots */]),
        new Lines(
            lines: [
                new SlotLine(values: [48, 56, 41], color: 'red', pointColor: 'red'),
            ],
        ),
    ],
);

Give it as many values as there are boxplots or bars, and list the Lines after them so the line is drawn on top. SlotLine accepts the same size, yAxis, color, areaColor, curve and stepLine options as Line; points are drawn only when pointColor is set.

Annotations

You can add annotations to your charts for better visualization.

use Maantje\Charts\Annotations\PointAnnotation;
use Maantje\Charts\YAxis;

$chart = new Chart(
    yAxis: new YAxis(
        annotations: [
            new PointAnnotation(x: 200, y: 120, label: 'Important Point'),
        ],
    ),
    // ...
);

License

The MIT License (MIT). Please see License File for more information.

lennyrouanet / charts

Package info

Security

Fund package maintenance!

Statistics

README

Features

Installation

Usage Examples

Example Usage With mPDF

Simple Line Chart

Curved Line Chart

Step line chart

Area line chart

Bar Chart

Stacked Bar Chart

Grouped Bar Chart

Advanced Line Chart

Advanced Bar Chart

Mixed chart

Negative Values Chart

Simple boxplot chart

Boxplot chart with a line

Pie chart

Usage

Creating a Chart

Simple Bar Chart

Simple Line Chart

Simple Boxplot Chart

Line over boxplots or bars

Annotations

License