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 型の値を設定する必要があります：

以下のオプションのオプションパラメータでは、value に string 型の値を設定する必要があります：

以下のオプションのオプションパラメータでは、value に配列を設定する必要があります：

以下のオプションのオプションパラメータでは、value にストリームリソース（例：fopen() を使用）を設定する必要があります：

以下のオプションのオプションパラメータでは、value にコールバック関数名を設定する必要があります：

戻り値

成功した場合は TRUE、失敗した場合は FALSE を返します。

更新履歴

例

新しい cURL セッションを初期化し、Webページを取得する

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

ファイルアップロードの例:

<?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エンコードされた文字列を渡すと、データは application/x-www-form-urlencoded としてエンコードされます。

PHP cURL リファレンスマニュアル