PHP cURL curl_share_close() Function

---

---

The PHP cURL curl_share_close() function is used to end or close a cURL share handle that was created previously with the help of the curl_share_init(). This function is helpful to clean and make resources free.

Syntax

Below is the syntax of the PHP cURL curl_share_close() function −

void curl_share_close (resource $sh)

Parameters

This function accepts $sh parameter which is a cURL share handle returned by curl_share_init().

Return Value

The curl_share_close() function returns does not return any value.

PHP Version

First introduced in core PHP 5.5.0, the curl_share_close() function continues to function easily in PHP 7, and PHP 8.

Example 1

Here the first basic example of the PHP cURL curl_share_close() function to close the cURL share handle $sh.

<?php
   // Create cURL share handle 
   // Set it to share cookie data
   $sh = curl_share_init();
   curl_share_setopt($sh, CURLSHOPT_SHARE, CURL_LOCK_DATA_COOKIE);

   // Start the first cURL handle 
   // Assign the share handle to it
   $ch1 = curl_init("http://example.com/");
   curl_setopt($ch1, CURLOPT_SHARE, $sh);

   // Execute the 1st cURL handle
   curl_exec($ch1);

   // Start the second cURL handle 
   // Assign the share handle to it
   $ch2 = curl_init("http://example.net/");
   curl_setopt($ch2, CURLOPT_SHARE, $sh);

   // Execute the second cURL handle
   curl_exec($ch2);

   // Close the cURL share handle
   curl_share_close($sh);

   // Close the cURL handles
   curl_close($ch1);
   curl_close($ch2);
?>

Output

Here is the outcome of the following code −

Example 2

In the below PHP code we will use the curl_share_close() function close the share handles to share the DNS cache between two cURL sessions.

<?php
   // Start a cURL share handle
   $sh = curl_share_init();
   
   // Set options to share DNS cache
   curl_share_setopt($sh, CURLSHOPT_SHARE, CURL_LOCK_DATA_DNS);
   
   // Start two cURL sessions
   $ch1 = curl_init('http://example.com');
   $ch2 = curl_init('http://example.org');
   
   // Set both sessions to use the same share handle
   curl_setopt($ch1, CURLOPT_SHARE, $sh);
   curl_setopt($ch2, CURLOPT_SHARE, $sh);
   
   // Perform the cURL sessions
   curl_exec($ch1);
   curl_exec($ch2);
   
   // Close the cURL sessions
   curl_close($ch1);
   curl_close($ch2);
   
   // Close the share handle
   curl_share_close($sh);
?> 

Output

The content of both the URLs will be displayed −

Example 3

This code starts two cURL sessions then transfers cookie information and then closes both sessions and the share handle using the curl_share_close().

<?php
   // Start a cURL share handle
   $sh = curl_share_init();
   
   // Set options to share cookie data
   curl_share_setopt($sh, CURLSHOPT_SHARE, CURL_LOCK_DATA_COOKIE);
   
   // Start two cURL sessions
   $ch1 = curl_init('http://example.com');
   $ch2 = curl_init('http://example.org');
   
   // Set both sessions to use the same share handle
   curl_setopt($ch1, CURLOPT_SHARE, $sh);
   curl_setopt($ch2, CURLOPT_SHARE, $sh);
   
   // Perform the cURL sessions
   curl_exec($ch1);
   curl_exec($ch2);
   
   // Close the cURL sessions
   curl_close($ch1);
   curl_close($ch2);
   
   // Close the share handle
   curl_share_close($sh);
?> 

Output

This will create the below output −

Example 4

In the following example, we are using the curl_share_close() function to get the fetch the primary IP address with the number of redirects.

<?php
   // Start a cURL share handle
   $sh = curl_share_init();
   
   // Check if share handle was created successfully
   if ($sh === false) {
       die('Failed to create cURL share handle');
   }
   
   // Set options to share SSL sessions
   curl_share_setopt($sh, CURLSHOPT_SHARE, CURL_LOCK_DATA_SSL_SESSION);
   
   // Start a cURL session
   $ch = curl_init('http://abc123.com');
   
   // Check if cURL session was created successfully
   if ($ch === false) {
       curl_share_close($sh);
       die('Failed to create cURL session');
   }
   
   // Set the share handle
   curl_setopt($ch, CURLOPT_SHARE, $sh);
   
   // Perform the cURL session
   $result = curl_exec($ch);
   
   // Check for errors
   if ($result === false) {
       echo 'cURL error: ' . curl_error($ch);
   }
   
   // Close the cURL session
   curl_close($ch);
   
   // Close the share handle
   curl_share_close($sh);
?> 

Output

Following is the output of the above code −

Object not found!

Error 404