PHP - RRD rrd_lastupdate() Function

---

---

The PHP RRD rrd_lastupdate() function is used to fetch the most recent update to the given RRD file. This function helps in retrieving the latest data stored in the RRD file.

Syntax

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

array rrd_lastupdate ( string $file )

Parameters

This function accepts $file parameter which is the path to the RRD file.

Return Value

The rrd_lastupdate() function returns an array of information about last update 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_lastupdate() function to get the last update information from an RRD file. So it basically fetches the last update information from the file and prints it.

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

Output

The above code will result something like this −

Array
(
    [last_update] => 1672531199
    [data] => Array
        (
            [value1] => 1234
            [value2] => 5678
        )
)

Example 2

In the below PHP code we will use the rrd_lastupdate() function and handle a case where the RRD file does not exist.

<?php
   // Mention the filename here
   $filename = '/PHP/PhpProjects/myfile.rrd';
   $result = rrd_lastupdate($rrd_file);
   if ($result === false) {
       echo "Error: Unable to fetch data from RRD file.";
   } else {
       print_r($result);
   }
?> 

Output

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

Error: Unable to fetch data from RRD file.

Example 3

This example shows how to save last update information in different variables with the help of rrd_lastupdate() function. So different variables are used to record the data and the last update time.

<?php
   // Mention the filename here
   $filename = '/PHP/PhpProjects/example.rrd';
   $result = rrd_lastupdate($rrd_file);
   if ($result !== false) {
       $last_update = $result['last_update'];
       $data = $result['data'];
       echo "Last Update Time: " . date('Y-m-d H:i:s', $last_update) . "\n";
       echo "Data: " . json_encode($data) . "\n";
   }
?> 

Output

This will create the below output −

Last Update Time: 2023-01-01 00:00:00
Data: {"value1":1234,"value2":5678}

Important Note

The RRD rrd_lastupdate() function is a built-in method in PHP which is used to get the last update to the RRD file. And we have seen different examples to show how to use this function in a different cases.