PHPCon Poland 2024


(PECL rrd >= 0.9.0)

rrd_graphСоздаёт изображение из данных


rrd_graph(string $filename, array $options): array

Создаёт изображение для определённых данных из RRD-файла.

Список параметров


Имя файла для вывода графика. Это, как правило, заканчивается либо .png, .svg или .eps, в зависимости от нужного формата вывода.


Опции для генерации изображения. Смотрите страницу руководства для команды rrd graph для получения всех возможных вариантов. Все опции (определения данных, определения переменных и т.д.) разрешены.

Возвращаемые значения

Возвращается массив с информацией о сгенерированном изображении или false, если возникла ошибка.

add a note

User Contributed Notes 6 notes

4 years ago
This documentation page is useless ...

"See man page of rrd graph for all possible options"

I thought I am looking at the documentation, of not, why not provide a link ?
10 years ago
You can get the latest RRD Error by simply doing print_r(rrd_error()) immediately after the rrd_graph() call.
Matt C
12 years ago
Note; apache server requires write access to the folder in which the image is to be created otherwise no image file is produced, and (unhelpfully) no error is generated.
info at ukee dot nl
9 years ago
When using style features like: --font TITLE:13:Times
use in your code: --font=TITLE:13:Times

the "=" is missing in the documentation
10 years ago
When I add

--font AXIS:8:

into $options,

I receive the next error:

PNG creation error: unknown option '--font AXIS:8:'

According to docs from rrdtool site the right syntax is:

[-n|--font FONTTAG:size:[font]]

This lets you customize which font to use for the various text elements on the RRD graphs. DEFAULT sets the default value for all elements, TITLE for the title, AXIS for the axis labels, UNIT for the vertical unit label, LEGEND for the graph legend, WATERMARK for the watermark on the edge of the graph.

Use Times for the title: --font TITLE:13:Times

Note that you need to quote the argument to --font if the font-name contains whitespace: --font "TITLE:13:Some Font"

If you do not give a font string you can modify just the size of the default font: --font TITLE:13:.
To Top