php man page for curl_file_create

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)