curl_share_setopt(3) [php man page]

CURL_SHARE_SETOPT(3)							 1						      CURL_SHARE_SETOPT(3)

curl_share_setopt - Set an option for a cURL share handle.

SYNOPSIS

       bool curl_share_setopt (resource  $sh, int  $option, string  $value)

DESCRIPTION

	Sets an option on the given cURL share handle.

PARAMETERS

	      o $sh
		- A cURL share handle returned by curl_share_init(3).

	      o $option
		-

	      +------------------+--------------------------------------+---+
	      |     Option	 |					|   |
	      | 		 |					|   |
	      | 		 |	       Description		|   |
	      | 		 |					|   |
	      +------------------+--------------------------------------+---+
	      | 		 |					|   |
	      | CURLSHOPT_SHARE  |					|   |
	      | 		 |					|   |
	      | 		 |  Specifies	a  type  of  data  that |   |
	      | 		 | should be shared.			|   |
	      | 		 |					|   |
	      | 		 |					|   |
	      |CURLSHOPT_UNSHARE |					|   |
	      | 		 |					|   |
	      | 		 |  Specifies a type of data that  will |   |
	      | 		 | be no longer shared. 		|   |
	      | 		 |					|   |
	      +------------------+--------------------------------------+---+
	      o $value
		-

	      +---------------------------+--------------------------------------+---+
	      | 	 Value		  |					 |   |
	      | 			  |					 |   |
	      | 			  |		Description		 |   |
	      | 			  |					 |   |
	      +---------------------------+--------------------------------------+---+
	      | 			  |					 |   |
	      |  CURL_LOCK_DATA_COOKIE	  |					 |   |
	      | 			  |					 |   |
	      | 			  |	     Shares cookie data.	 |   |
	      | 			  |					 |   |
	      | 			  |					 |   |
	      |    CURL_LOCK_DATA_DNS	  |					 |   |
	      | 			  |					 |   |
	      | 			  |  Shares  DNS  cache.  Note that when |   |
	      | 			  | you use cURL multi handles, all han- |   |
	      | 			  | dles  added to the same multi handle |   |
	      | 			  | will share DNS cache by default.	 |   |
	      | 			  |					 |   |
	      | 			  |					 |   |
	      |CURL_LOCK_DATA_SSL_SESSION |					 |   |
	      | 			  |					 |   |
	      | 			  |  Shares SSL  session  IDs,	reducing |   |
	      | 			  | the  time spent on the SSL handshake |   |
	      | 			  | when  reconnecting	 to   the   same |   |
	      | 			  | server.  Note  that  SSL session IDs |   |
	      | 			  | are reused within the same handle by |   |
	      | 			  | default.				 |   |
	      | 			  |					 |   |
	      +---------------------------+--------------------------------------+---+
RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      curl_share_setopt(3) example

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

	      <?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);

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

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

PHP Documentation Group 												      CURL_SHARE_SETOPT(3)

Check Out this Related Man Page

CURL_SETOPT_ARRAY(3)							 1						      CURL_SETOPT_ARRAY(3)

curl_setopt_array - Set multiple options for a cURL transfer

SYNOPSIS

       bool curl_setopt_array (resource  $ch, array  $options)

DESCRIPTION

	Sets  multiple options for a cURL session. This function is useful for setting a large amount of cURL options without repetitively calling
       curl_setopt(3).

PARAMETERS

	      o $ch
		-A cURL handle returned by curl_init(3).

	      o $options
		- An array specifying which options to set and their values. The keys should be valid curl_setopt(3) constants	or  their  integer
		equivalents.

RETURN VALUES

	Returns TRUE if all options were successfully set. If an option could not be successfully set, FALSE is immediately returned, ignoring any
       future options in the $options array.

EXAMPLES

       Example #1

	       Initializing a new cURL session and fetching a web page

	      <?php
	      // create a new cURL resource
	      $ch = curl_init();

	      // set URL and other appropriate options
	      $options = array(CURLOPT_URL => 'http://www.example.com/',
			       CURLOPT_HEADER => false
			      );

	      curl_setopt_array($ch, $options);

	      // grab URL and pass it to the browser
	      curl_exec($ch);

	      // close cURL resource, and free up system resources
	      curl_close($ch);
	      ?>

	Prior to PHP 5.1.3 this function can be simulated with:

       Example #2

	      Our own implementation of curl_setopt_array(3)

	      <?php
	      if (!function_exists('curl_setopt_array')) {
		 function curl_setopt_array(&$ch, $curl_options)
		 {
		     foreach ($curl_options as $option => $value) {
			 if (!curl_setopt($ch, $option, $value)) {
			     return false;
			 }
		     }
		     return true;
		 }
	      }
	      ?>

NOTES

       Note

	       As with curl_setopt(3), passing an array to CURLOPT_POST will encode the data as multipart/form-data, while passing  a  URL-encoded
	      string will encode the data as application/x-www-form-urlencoded.

SEE ALSO

       curl_setopt(3).

PHP Documentation Group 												      CURL_SETOPT_ARRAY(3)

Linux and UNIX Man Pages

curl_share_setopt(3) [php man page]

Check Out this Related Man Page