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

    Якщо задано, опція CURLOPT_URL матиме це саме значення. Його можна встановити вручну за допомогою функції curl_setopt().

    Зауваження:

    Файловий протокол вимкнений у cURL, якщо встановлено open_basedir.

    Значення, що повертаються

    У разі успіху повертає дескриптор cURL, якщо виникли помилки — false.

    Журнал змін

    Версія Опис
    8.0.0 Тепер у разі успіху ця функція повертає екземпляр CurlHandle; раніше повертався ресурс.
    8.0.0 url тепер може мати значення null.

    Приклади

    Приклад #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);
    ?>

    Прогляньте також

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    2
    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
    -7
    VictorWumble
    11 months 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
    To Top