Php/docs/function.curl-exec

• PHP Manual
• cURL 関数
• cURL セッションを実行する

curl_exec

(PHP 4 >= 4.0.2, PHP 5, PHP 7)

curl_exec — cURL セッションを実行する

説明

curl_exec ( CurlHandle $handle ) : string|bool

指定した 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/%22);curl_setopt($ch, CURLOPT_HEADER, 0);// URL を取得し、ブラウザに渡しますcurl_exec($ch);// cURL リソースを閉じ、システムリソースを解放しますcurl_close($ch);?>

参考

• curl_multi_exec() - 現在の cURL ハンドルから、サブ接続を実行する