PHP curl_setopt_array関数

PHP Calendar 参考手册PHP cURLリファレンスマニュアル

(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 ページを取得します。

例

<?php //新しい 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 Calendar 参考手册PHP cURLリファレンスマニュアル

その他の拡張モジュール