curl_file_create(3) [php man page]

CURL_FILE_CREATE(3)							 1						       CURL_FILE_CREATE(3)

CURLFile::__construct - Create a CURLFile object

       Object oriented style

SYNOPSIS

       public CURLFile::__construct (string  $filename, [string  $mimetype], [string  $postname])

DESCRIPTION

       Procedural style
       CURLFile curl_file_create (string  $filename, [string  $mimetype], [string  $postname])

	Creates a CURLFile object, used to upload a file with CURLOPT_POSTFIELDS.

PARAMETERS

	      o $filename
		- Path to the file which will be uploaded.

	      o $mimetype
		- Mimetype of the file.

	      o $postname
		- Name of the file to be used in the upload data.

RETURN VALUES

	Returns a CURLFile object.

EXAMPLES

       Example #1

	      curl_file_create(3) example

	      Object oriented style

	      <?php
	      /* http://example.com/upload.php:
	      <?php var_dump($_FILES); ?>
	      */

	      // Create a cURL handle
	      $ch = curl_init('http://example.com/upload.php');

	      // Create a CURLFile object
	      $cfile = new CURLFile('cats.jpg','image/jpeg','test_name');

	      // Assign POST data
	      $data = array('test_file' => $cfile);
	      curl_setopt($ch, CURLOPT_POST,1);
	      curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

	      // Execute the handle
	      curl_exec($ch);
	      ?>

	      Procedural style

	      <?php
	      /* http://example.com/upload.php:
	      <?php var_dump($_FILES); ?>
	      */

	      // Create a cURL handle
	      $ch = curl_init('http://example.com/upload.php');

	      // Create a CURLFile object
	      $cfile = curl_file_create('cats.jpg','image/jpeg','test_name');

	      // Assign POST data
	      $data = array('test_file' => $cfile);
	      curl_setopt($ch, CURLOPT_POST,1);
	      curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

	      // Execute the handle
	      curl_exec($ch);
	      ?>

	      The above example will output:

	      array(1) {
		["test_file"]=>
		array(5) {
		  ["name"]=>
		  string(9) "test_name"
		  ["type"]=>
		  string(10) "image/jpeg"
		  ["tmp_name"]=>
		  string(14) "/tmp/phpPC9Kbx"
		  ["error"]=>
		  int(0)
		  ["size"]=>
		  int(46334)
		}
	      }

SEE ALSO

       curl_setopt(3).

PHP Documentation Group 												       CURL_FILE_CREATE(3)

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)