PHP curl_setopt() 函数用法及示例

PHP CURL参考手册

(PHP 4 >= 4.0.2, PHP 5)

curl_setopt — 设置一个CURL传输选项。

语法

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

为给定的CURL会话句柄设置一个选项。

参数

ch

由 curl_init() 返回的 CURL 句柄。

option

需要设置的CURLOPT_XXX选项。

value

将设置在option选项上的值。

对于下面的这些option的可选参数，value应该被设置一个bool类型的值：

对于下面的这些option的可选参数，value应该被设置一个integer类型的值：

对于下面的这些option的可选参数，value应该被设置一个string类型的值：

对于下面的这些option的可选参数，value应该被设置一个数组：

对于下面的这些option的可选参数，value应该被设置一个流资源 （例如使用fopen()）：

对于下面的这些option的可选参数，value应该被设置为一个回调函数名：

返回值

成功时返回 TRUE， 或者在失败时返回 FALSE。

更新日志

在线示例

初始化一个新的CURL会话并获取一个网页

<?php
// 创建一个新CURL资源
$ch = curl_init();
// 设置URL和相应的选项
curl_setopt($ch, CURLOPT_URL, "/");
curl_setopt($ch, CURLOPT_HEADER, false);
// 抓取URL并把它传递给浏览器
curl_exec($ch);
//关闭CURL资源，并且释放系统资源
curl_close($ch);
?>

上传文件示例:

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

以上示例输出结果如下：

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

注释

传递一个数组到CURLOPT_POSTFIELDS，CURL会把数据编码成 multipart/form-data，而然传递一个URL-encoded字符串时，数据会被编码成 application/x-www-form-urlencoded。

PHP CURL参考手册