PHP - RRD rrd_last() Function

---

---

The PHP RRD rrd_last() function is used to get the timestamp of the last data sample in an RRD file. This function is a part of the RRD toolkit, which is used to manage time series data.

Syntax

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

int rrd_last(string $filename)

Parameters

This function accepts $filename parameter which is the location to the RRD file from which you want to get the last update timestamp.

Return Value

The rrd_last() function returns integer showing the Unix timestamp of the most recent data from the RRD database.

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_last() function to get the last update timestamp of an RRD file.

<?php
   // Mention the filename here
   $filename = '/PHP/PhpProjects/example.rrd';
   $last_update = rrd_last($filename);
   echo "Last update timestamp: " . $last_update;
?>

Output

The above code will result something like this −

Last update timestamp: 1627891200

Example 2

This example first checks whether the RRD file exists before getting the most recent update timestamp with the help of rrd_last() method.

<?php
   // Mention the filename here
   $filename = '/PHP/PhpProjects/example.rrd';
   if (file_exists($filename)) {
       $last_update = rrd_last($filename);
       echo "Last update timestamp: " . $last_update;
   } else {
       echo "RRD file does not exist.";
   }
?> 

Output

After running the above program, it generates the following output if file is present −

Last update timestamp: 1627891200

If the RRD file is not present −

RRD file does not exist.

Example 3

Now the below code handle errors when the RRD file does not exist and prints the message to the console.

<?php
   // Mention the filename here
   $filename = '/PHP/PhpProjects/myfile.rrd';
   $last_update = rrd_last($filename);
   if ($last_update === FALSE) {
       echo "Failed to get the last update timestamp.";
   } else {
       echo "Last update timestamp: " . $last_update;
   }
?> 

Output

This will create the below output −

Failed to get the last update timestamp.

Example 4

In the following example, we are using the rrd_last() function and convert the timestamp to a human-readable date.

<?php
   // Mention the filename here
   $filename = '/PHP/PhpProjects/example.rrd';
   $last_update = rrd_last($filename);
   if ($last_update !== FALSE) {
       echo "Last update date: " . date('Y-m-d H:i:s', $last_update);
   } else {
       echo "Failed to get the last update timestamp.";
   }
?> 

Output

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

Last update date: 2024-08-06 02:27:05