PHP - RRD rrdc_disconnect() Function

---

---

The PHP RRD rrdc_disconnect() function is used to close any outstanding connection to rrd caching daemon. This function is used to make sure that the connection is properly closed when it is no longer needed.

This function is called automatically when the PHP process is stopped. It depends on the SAPI that is being used. For example, it is executed automatically at the end of a command-line script. It is up to the user whether to call this function at the end of each request or not.

Syntax

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

void rrdc_disconnect ()

Parameters

This function does not take any parameter.

Return Value

The rrdc_disconnect() function does not return any value.

PHP Version

The rrdc_disconnect() function is available from version 1.1.2 of the PECL rrd extension onwards.

Example 1

Here is the basic example of the PHP RRD rrdc_disconnect() function disconnect it after making a connection to an RRDtool server.

<?php
   // Mention the host here
   $host = 'localhost';
   $port = 13900;
   $host = rrdc_connect($host, $port);
   
   if ($host) {
       echo "Connected to RRDtool server.\n";
       rrdc_disconnect($host);
       echo "Disconnected successfully.\n";
   } else {
       echo "Failed to connect to RRDtool server.\n";
   }
?>

Output

The above code will result something like this −

Connected to RRDtool server.
Disconnected successfully.

Example 2

In this PHP code we will use the rrdc_disconnect() function and disconnect the server but before disconnecting we will perform some operations.

<?php
   $host = rrdc_connect('localhost', 13900);

   if ($host) {
       // Perform some operations here
       echo "Operations performed.\n";
       rrdc_disconnect($host);
       echo "Disconnected successfully.\n";
   } else {
       echo "Failed to connect to RRDtool server.\n";
   }
?> 

Output

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

Operations performed.
Disconnected successfully.

Example 3

Now we will handle multiple connections in the below example and make sure that both the connections have been disconnected with the help of rrdc_disconnect() function.

<?php
   // Multiple connections
   $host1 = rrdc_connect('localhost', 13900);
   $host2 = rrdc_connect('localhost', 13901);
   
   if ($host1 && $host2) {
       echo "Both the connections established.\n";
       rrdc_disconnect($host1);
       rrdc_disconnect($host2);
       echo "Both the connections disconnected.\n";
   } else {
       echo "Failed to establish both connections.\n";
   }
?> 

Output

This will create the below output −

Both the connections established.
Both the connections disconnected.

Example 4

In the following example, we are using the rrdc_disconnect() function to handle errors when trying to disconnect the server.

<?php
   // 
   $host = rrdc_connect('localhost', 13900);

   if ($host) {
      echo "Connected to RRDtool server.\n";
      // An invalid host resource 
      $invalidhost = null;

      rrdc_disconnect($invalidhost); 
      echo "Tried to disconnect an invalid host.\n";
       
      rrdc_disconnect($host);
      echo "Disconnected successfully.\n";
   
   } else {
      echo "Failed to connect to RRDtool server.\n";
   }
?> 

Output

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

Connected to RRDtool server.
Tried to disconnect an invalid socket.
Disconnected successfully.