Switch branches/tags
Clone or download


Build status Latest Stable Version Total Downloads License Monthly Downloads Daily Downloads

Graphviz generation for PHP

Build Status


Install the latest version with:

composer require alom/graphviz


This library allow you to create Dot Graph with a PHP fluid interface:

$graph = new Alom\Graphviz\Digraph('G');
        ->attr('node', array('style' => 'filled', 'fillcolor' => 'blue'))
        ->edge(array('b0', 'b1', 'b2', 'b3'))
    ->edge(array('A', 'B', 'C'))
echo $graph->render();

Escaping of labels

By default, labels will be escaped, so that your PHP string is represented "as it is" in the graph. If you don't want the label to be escaped, add set the special _escaped attribute to false:

$graph = new Alom\Graphviz\Digraph('G');
    ->node('my_table', array(
        'label' => '<<table>...</table>>',
        '_escaped' => false

Browsing the graph

When you have created lot of subgraphs and nodes, it might be useful to be able to browse it using identifiers. For example, if you have the following graph:

$graph = new Alom\Graphviz\Digraph('G');
    ->edge(array('C', 'D'))

You can do the following to access the nodes in the existing graph:

$cluster = $graph->get('cluster_1');
$node = $graph->get('cluster_2')->get('D');

When you have a node or an edge, you can manipulate its attributes:

# read a value
echo $node->getAttribute('label', 'no label'); # second argument is default value

# write a value
$node->attribute('label', 'new label');

On a graph, you can access or verify edge existence:

$graph->hasEdge(array('A', 'B'));
$graph->getEdge(array('C', 'D'));

Using cluster and record IDs

If you create an edge from/to an ID inside a record, use an array instead of a string:

$graph = new Alom\Graphviz\Digraph('G');
    ->node('A', array('shape' => 'record', 'label' => '{ <1> Part 1 | <2> Part 2}'))
    ->edge(array('B', array('A', '1')))

As you can see in the example above, the edge is composed of two parts:

  • 'B': a regular node
  • array('A', '1'): targets the cell "1" inside the A node

This method also work for getEdge, hasEdge and every edge-related method.


Take a look at examples located in samples folder:

You can generate any of those graph by using the following commands:

php samples/00-readme.php | dot -Tpdf -oout.pdf
xdg-open out.pdf