CURLFile::__construct

(PHP 5 >= 5.5.0, PHP 7)

Create a CURLFile object

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

Object oriented style

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:

filename

Path to the file which will be uploaded.

mimetype

Mimetype of the file.

postname

Name of the file to be used in the upload data.

Returns:

Returns a CURLFile object.

Examples:

CURLFile::__construct() 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)
  }
}