PHP curl_setopt_array() 関数の用法と例

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セッションを初期化し、ウェブページをキャプチャします。

<?php
//　新しいCURLリソースを作成します
$ch = curl_init();
　
//　URLと関連するオプションを設定します
$options = array(CURLOPT_URL => 'https://ja.oldtoolbag.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/フォーム-dataの形式でエンコードされますが、URLを-エンコードされた文字列はapplication/x-www-フォーム-データをエンコードするurlencodedの方法。

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