PHP - RRD rrd_info() Function

---

---

The PHP RRD rrd_info() function is used to get the information about an RRD file. It also contains information on the data sources, the date the RRD file was generated, the number of data points, and other details.

Syntax

Below is the syntax of the PHP RRD rrd_info() function −

array rrd_info ( string $filename )

Parameters

This function accepts $filename parameter which is the path to the RRD file that you want to know about.

Return Value

The rrd_info() function returns an array with information about the given RRD file, or FALSE on failure.

PHP Version

This function is available from version 0.9.0 of the PECL rrd extension onwards.

Example 1

First we will show you the basic example of the PHP RRD rrd_info() function to get basic information about the given RRD file.

<?php
   // Mention the filename here
   $filename = '/PHP/PhpProjects/example.rrd';
   $info = rrd_info($filename);
   print_r($info);
?>

Output

The above code will result something like this −

Array
(
    [filename] => /PHP/PhpProjects/example.rrd
    [rrd_version] => 0003
    [step] => 300
    [last_update] => 1625158800
)

Example 2

This example demonstrates how to extract and show specific information from an RRD file with the help of rrd_info() function.

<?php
   // Mention filename here
   $filename = '/PHP/PhpProjects/example.rrd';
   $info = rrd_info($filename);
   echo "RRD Version: " . $info['rrd_version'] . "\n";
   echo "Last Update: " . $info['last_update'] . "\n";
?> 

Output

After running the above program, it generates the following output −

RRD Version: 0003
Last Update: 1625158800

Example 3

Now the below example demonstrates how to handle problems when the RRD file does not exist while using rrd_info() function.

<?php
   // Mention the filename here
   $filename = '/PHP/PhpProjects/myfile.rrd';
   $info = @rrd_info($filename);
   if ($info === false) {
       echo "Failed to retrieve information. The RRD file might not exist.\n";
   } else {
       print_r($info);
   }
?> 

Output

This will create the below output −

Failed to retrieve information. The RRD file might not exist.

Example 4

In the following example, we are using the rrd_info() function and we will iterate over and prints all of the information keys and values from the given RRD file.

<?php
   // Mention filename here
   $filename = '/PHP/PhpProjects/example.rrd';
   $info = rrd_info($filename);
   foreach ($info as $key => $value) {
       echo "$key: $value\n";
   }
?> 

Output

When the above program is executed, it will produce the below output −

filename: /PHP/PhpProjects/example.rrd
rrd_version: 0003
step: 300
last_update: 1625158800