# curl_init

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

curl_init — 初始化 cURL 会话

### 说明

curl_init ([ string `$url` = `NULL` ] ) : resource

初始化新的会话，返回 cURL 句柄，供curl_setopt()、 curl_exec() 和 curl_close() 函数使用。

### 参数

`url`

  如果提供了该参数，`CURLOPT_URL` 选项将会被设置成这个值。你也可以使用curl_setopt()函数手动地设置这个值。

  > Note:

  > 如果设置了 open_basedir，file 协议会被 cURL 禁用。

### 返回值

如果成功，返回 cURL 句柄，出错返回 `FALSE`。

### 范例

Example #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资源，并且释放系统资源
    curl_close($ch);
    ?>

### 参见

- curl_close() - 关闭 cURL 会话
- curl_multi_init() - 返回一个新cURL批处理句柄