Edit Report a Bug

    curl_init

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

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

    説明

    curl_init(?string $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/");
    curl_setopt($ch, CURLOPT_HEADER, 0);

    // URL を取得し、ブラウザに渡します
    curl_exec($ch);

    // cURL リソースを閉じ、システムリソースを解放します
    curl_close($ch);
    ?>

    参考

    add a note add a note

    User Contributed Notes 2 notes

    up
    1
    NextgenThemes
    1 year ago
    This may be obvious, but:

    Note that is MUCH faster to use use a single instance to make a series of curl requests rather than creating a new instance for each request.
    up
    0
    VictorWumble
    1 year ago
    NextgenThemes' note is applicable for very very limited situations. For completeness's sake, let's consider the following code snippet:

    <?php

    /*
    Your localhost has a default Apache which simply returns "It works!"
    */

    $repeatCount = 1000;

    // begin section
    // this section is slow

    // call localhost, create new handle each time
    $time = microtime(true);
    foreach (    range(1, $repeatCount) as $ignored) {
            $ch = curl_init("http://localhost");
            curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
            $response = curl_exec($ch);
            // do something with the response
            unset($response);
            curl_close($ch);
    }
    unset(    $ch);
    $elapsed = microtime(true) - $time;
    echo     "Recreate curl handle, time taken: " . $elapsed . "\n";

    // end section

    // begin section
    // this section is much faster

    // call localhost, but reuse the handle
    $time = microtime(true);
    $ch = curl_init("http://localhost");
    foreach (    range(1, $repeatCount) as $ignored) {
            curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
            $response = curl_exec($ch);
            // do something with the response
            unset($response);
    }
    curl_close($ch);
    $elapsed = microtime(true) - $time;
    echo     "Reuse curl handle, time taken: " . $elapsed . "\n";

    // end section

    /*
    Example output:
    Recreate curl handle, time taken: 11.289301872253
    Reuse curl handle, time taken: 0.53790807723999
    */

    ?>

    The above code supports the claim by NextgenThemes, however the "send curl requests in sequence" method in general is unnecessarily slow because:
    - network transfer time (e.g. 100ms)
    - remote processing time (e.g. 50ms)
    - usually, no need to send requests in specific sequence

    So, in practice, when you need to send multiple curl requests at the same time, just use the curl_multi_init method. Don't consider the "send curl requests in sequence" method unless you have very very specific/special needs.
    add a note add a note
    To Top