PHP curl_setopt function

PHP cURL Reference Manual

(PHP 4 >= 4.0.2, PHP 5)

curl_setopt — Set a cURL transfer option.

Description

bool curl_setopt ( resource $ch , int $option , mixed $value )

Sets an option for the given cURL session handle.

Parameters

ch

cURL handle returned by curl_init().

option

The CURLOPT_XXX option to set.

value

The value to set on the option.

For the following optional parameters for these options, value should be set to a bool value:

For the following optional parameters for these options, value should be set to an integer value:

For the following options, the value parameter should be set to a string value:

For the following options, the value parameter should be set to an array:

For the following options, the value parameter should be set to a stream resource (e.g., using fopen()):

For the following options, the value parameter should be set to a callback function name:

Return Values

Returns TRUE on success, or FALSE on failure.

Changelog

Examples

Initialize a new cURL session and fetch a web page

<?php
// 创建一个新cURL资源
$ch = curl_init();

// 设置URL和相应的选项
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, false);

// 抓取URL并把它传递给浏览器
curl_exec($ch);

//关闭cURL资源，并且释放系统资源
curl_close($ch);
?>

File upload example:

<?php

/* http://localhost/upload.php:
print_r($_POST);
print_r($_FILES);
*/

$ch = curl_init();

$data = array('name' => 'Foo', 'file' => '@/home/user/test.png');

curl_setopt($ch, CURLOPT_URL, 'http://localhost/upload.php');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

curl_exec($ch);
?>

The above example will output:

Array
(
    [name] => Foo
)
Array
(
    [file] => Array
        (
            [name] => test.png
            [type] => image/png
            [tmp_name] => /tmp/phpcpjNeQ
            [error] => 0
            [size] => 279
        )

)

Notes

Passing an array to CURLOPT_POSTFIELDS will cause cURL to encode the data as multipart/form-data, while passing a URL-encoded string will cause the data to be encoded as application/x-www-form-urlencoded.

PHP cURL Reference