cURL セッションを実行する

# curl_exec

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

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

### 説明

function curl_exec(CurlHandle `$handle`): string|bool

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

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

### パラメータ

`handle`
  curl_init() が返す cURL ハンドル。

### 戻り値

成功時には、この関数は結果を直接 `stdout` にフラッシュし、`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_multi_exec() - 現在の cURL ハンドルから、サブ接続を実行する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open