Php/docs/function.curl-init

• PHP Manual
• cURL 関数
• cURL セッションを初期化する

curl_init

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

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

説明

curl_init ([ string|null $url = null ] ) : CurlHandle|false

新規セッションを初期化し、cURL ハンドルを返します。このハンドルは、関数 curl_setopt(), curl_exec(), curl_close() で使用します。

パラメータ

url

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

参考

• curl_close() - cURL セッションを閉じる
• curl_multi_init() - 新規 cURL マルチハンドルを返す