curl_reset

libcurl セッションハンドルのすべてのオプションをリセットする

説明

void curl_reset(CurlHandle $handle)

指定した cURL ハンドルに設定されているすべてのオプションを初期化してデフォルト値に戻します。

パラメータ

handle: curl_init が返す cURL ハンドル。

戻り値

値を返しません。

変更履歴

バージョン	説明
8.0.0	`handle` は CurlHandle クラスのインスタンスを期待するようになりました。これより前のバージョンでは、resource を期待していました。

例

例1 curl_reset の例

<?php
// curl ハンドルを作ります
$ch = curl_init();

// CURLOPT_USERAGENT オプションを設定します
curl_setopt($ch, CURLOPT_USERAGENT, "My test user-agent");

// これまでに設定されたすべてのオプションを初期化します
curl_reset($ch);

// HTTP リクエストを送信します
curl_setopt($ch, CURLOPT_URL, 'http://example.com/');
curl_exec($ch); // 事前に設定した user-agent は送信されません。curl_reset で初期化されたからです

// ハンドルを閉じます
curl_close($ch);
?>

注意

注意:
curl_reset は、curl_init のパラメータで指定した URL も初期化します。

参考

curl_setopt