php8.5
Home/ Manual/ curl / functions/ curl_share_setopt

curl_share_setopt

PHP function Edit on GitHub ✎

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

Set an option for a cURL share handle

Description

curl_share_setopt(CurlShareHandle $share_handle, int $option, mixed $value): bool

Sets an option on the given cURL share handle.

Parameters

option

One of the CURLSHOPT_* constants.

value

One of the CURL_LOCK_DATA_* constants.

Return Values

Success

Changelog

VersionDescription

Examples

curl_share_setopt() example

This example will create a cURL share handle, add two cURL handles to it, and then run them with cookie data sharing.

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

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

// Execute the first cURL handle
curl_exec($ch1);

// Initialize the second cURL handle and assign the share handle to it
$ch2 = curl_init("http://php.net/");
curl_setopt($ch2, CURLOPT_SHARE, $sh);

// Execute the second cURL handle
//  all cookies from $ch1 handle are shared with $ch2 handle
curl_exec($ch2);
?>

Source: reference/curl/functions/curl-share-setopt.xml · from the official PHP manual (php/doc-en)