Skip to content

maantje/charts

Folders and files

NameName
Last commit message
Last commit date
Jan 25, 2025
Jan 26, 2025
Jan 26, 2025
Jan 26, 2025
Jan 19, 2025
Sep 3, 2024
Jan 26, 2025
Jan 23, 2025
Sep 3, 2024
Sep 1, 2024

Repository files navigation

Charts - SVG Chart Rendering

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, and mixed charts
  • Fully customizable and extendable
  • Outputs pure SVG, allowing for:

Installation

To get started, install the package via composer:

composer require maantje/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

📄 View PDF document
View source

Simple Line Chart

Simple Line Chart
View source

Curved Line Chart

Curved Line Chart
View source

Step line chart

Step line chart
View source

Area line chart

Area line chart
View source

Bar Chart

Bar Chart
View source

Stacked Bar Chart

Stacked Bar Chart
View source

Grouped Bar Chart

Grouped Bar Chart
View source

Advanced Line Chart

Advanced Line Chart
View source

Advanced Bar Chart

Advanced Bar Chart
View source

Mixed chart

Mixed chart
View source

Pie chart

Pie chart
View source

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();

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.