curl_exec

cURL セッションを実行する

説明

stringbool curl_exec(CurlHandle $handle)

指定した cURL セッションを実行します。

この関数は、cURL セッションを初期化し、オプションを全て設定した後にコールする必要があります。

パラメータ

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

戻り値

成功した場合に true を、失敗した場合に false を返します。しかし、オプション CURLOPT_RETURNTRANSFER が設定されていると、成功した場合に取得結果、失敗した場合に false を返します。

警告

この関数は論理値 false を返す可能性がありますが、false として評価される値を返す可能性もあります。詳細については論理値のセクションを参照してください。この関数の返り値を調べるには ===演算子を使用してください。

注意:
(404 Not found のような) エラーを示すレスポンスステータスコードは、失敗とはみなされないことに注意してください。 curl_getinfo 関数が、そうしたチェックを行うのに使えます。

変更履歴

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

例

例1 ウェブページの取得

<?php
// 新規 cURL リソースを作成します
$ch = curl_init();

// URL や他の適当なオプションを設定します
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, 0);

// URL を取得し、ブラウザに渡します
curl_exec($ch);

// cURL リソースを閉じ、システムリソースを解放します
curl_close($ch);
?>

参考

curl_multi_exec