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 −

curl_share_close Example 1

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 −

curl_share_close Example 2

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 −

curl_share_close Example 3

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
php_function_reference.htm
Advertisements