curl_init

cURL セッションを初期化する

説明

CurlHandlefalse curl_init(stringnull $url = null)

新規セッションを初期化し、cURL ハンドルを返します。

パラメータ

url

この値を指定した場合、CURLOPT_URL オプションがその値に設定されます。 curl_setopt により、 この値を手動で設定することもできます。

注意:

open_basedir が設定されている場合、cURL で file プロトコルは使えなくなります。

戻り値

成功した場合に cURL ハンドル、エラー時に false を返します。

変更履歴

バージョン 説明
8.0.0 成功時に、この関数は CurlHandle クラスのインスタンスを返すようになりました。 これより前のバージョンでは、resource を返していました。
8.0.0 url は、nullable になりました。

例1 新しい cURL セッションを初期化し、ウェブページを取得する

<?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_close
  • curl_multi_init