PHP curl_setopt_array関数
(PHP 5 >= 5.1.3)
curl_setopt_array — cURL 転送セッションのオプションを一括設定する。
説明
bool curl_setopt_array ( resource $ch , array $options )
cURL 転送セッションのオプションを一括設定します。この関数は、大量の cURL オプションを設定する必要がある場合に非常に便利で、curl_setopt() を繰り返し呼び出す必要はありません。
パラメータ
ch
curl_init() が返す cURL ハンドル。
options
設定するオプションとその値を指定する array。配列のキーは、有効な curl_setopt() 定数またはそれに対応する整数値である必要があります。
戻り値
すべてのオプションが正常に設定された場合は TRUE を返します。いずれかのオプションを設定できない場合は、直ちに FALSE を返し、options 配列内の後続のオプションは無視されます。
例
新しい cURL セッションを初期化し、Web ページを取得します。
例
//新しい cURL リソースを作成します
$ch = curl_init();
//URL と対応するオプションを設定します
$options = array(CURLOPT_URL => 'https://www.example.com',
CURLOPT_HEADER => false
);
curl_setopt_array($ch, $options);
//URL を取得してブラウザに渡します
curl_exec($ch);
//cURL リソースを閉じ、システムリソースを解放します
curl_close($ch);
PHP 5.1.3 より前のバージョンでは、この関数を次のようにシミュレートできます:
curl_setopt_array() の同等の実装
<?php
if (!function_exists('curl_setopt_array')) {
function curl_setopt_array(&$ch, $curl_options)
{
foreach ($curl_options as $option => $value) {
if (!curl_setopt($ch, $option, $value)) {
return false;
}
}
return true;
}
}
?>
注意:curl_setopt() に関して、CURLOPT_POST に配列を渡すとデータは multipart/form-data としてエンコードされますが、URL エンコードされた文字列を渡すとデータは application/x-www-form-urlencoded としてエンコードされます。
その他の拡張モジュール
PHP cURLリファレンスマニュアル