Edit Report a Bug

    curl_multi_init

    (PHP 5, PHP 7, PHP 8)

    curl_multi_init — Liefert ein cURL-Mehrfach-Handle

    Beschreibung

    curl_multi_init(): CurlMultiHandle

    Erlaubt die asynchrone Verarbeitung mehrerer cURL-Handles.

    Parameter-Liste

    Diese Funktion besitzt keine Parameter.

    Rückgabewerte

    Gibt im Erfolgsfall ein cURL-Mehrfach-Handle zurück.

    Changelog

    Version Beschreibung
    8.0.0 Bei Erfolg gibt diese Funktion nun eine CurlHandle-Instanz zurück; vorher wurde eine Ressource zurückgegeben.

    Beispiele

    Beispiel #1 curl_multi_init()-Beispiel

    In diesem Beispiel werden zwei cURL-Handles erstellt, einem Mehrfach-Handle hinzugefügt und anschließend asynchron ausgeführt.

    <?php
    // zwei cURL-Ressourcen erstellen
    $ch1 = curl_init();
    $ch2 = curl_init();

    // URL und weitere Optionen setzen
    curl_setopt($ch1, CURLOPT_URL, "http://lxr.php.net/");
    curl_setopt($ch1, CURLOPT_HEADER, 0);
    curl_setopt($ch2, CURLOPT_URL, "http://www.php.net/");
    curl_setopt($ch2, CURLOPT_HEADER, 0);

    // Mehrfach-Handle erstellen
    $mh = curl_multi_init();

    // die zuvor erstellten Handles hinzufügen
    curl_multi_add_handle($mh,$ch1);
    curl_multi_add_handle($mh,$ch2);

    // Mehrfach-Handle ausführen

    do {
    $status = curl_multi_exec($mh, $active);
    if (    $active) {
    curl_multi_select($mh);
    }
    } while (    $active && $status == CURLM_OK);

    // Handles schliessen
    curl_multi_remove_handle($mh, $ch1);
    curl_multi_remove_handle($mh, $ch2);
    curl_multi_close($mh);

    ?>

    Siehe auch

    add a note add a note

    User Contributed Notes 4 notes

    up
    49
    w_haigh at yahoo dot com
    9 years ago
    Here's an easier to follow example, From : http://arguments.callee.info/2010/02/21/multiple-curl-requests-with-php/

    // build the individual requests, but do not execute them
    $ch_1 = curl_init('http://webservice.one.com/');
    $ch_2 = curl_init('http://webservice.two.com/');
    curl_setopt($ch_1, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch_2, CURLOPT_RETURNTRANSFER, true);
     
    // build the multi-curl handle, adding both $ch
    $mh = curl_multi_init();
    curl_multi_add_handle($mh, $ch_1);
    curl_multi_add_handle($mh, $ch_2);
     
    // execute all queries simultaneously, and continue when all are complete
      $running = null;
      do {
        curl_multi_exec($mh, $running);
      } while ($running);

    //close the handles
    curl_multi_remove_handle($mh, $ch1);
    curl_multi_remove_handle($mh, $ch2);
    curl_multi_close($mh);
     
    // all of our requests are done, we can now access the results
    $response_1 = curl_multi_getcontent($ch_1);
    $response_2 = curl_multi_getcontent($ch_2);
    echo "$response_1 $response_2"; // output results
    up
    45
    xxavalanchexx at gmail dot com
    10 years ago
    According to https://bugs.php.net/bug.php?id=61141:

    On Windows setups using libcurl version 7.24 or later (which seems to correspond to PHP 5.3.10 or later), you may find that curl_multi_select() always returns -1, causing the example code in the documentation to timeout. This is, apparently, not strictly a bug: according to the libcurl documentation, you should add your own sleep if curl_multi_select returns -1.

    Therefore, in order to work correctly on Windows for PHP 5.3.10+, the second loop in the example code should look something like the following:

    <?php
    while ($active && $mrc == CURLM_OK) {
        if (    curl_multi_select($mh) == -1) {
                usleep(100);
        }
        do {
                $mrc = curl_multi_exec($mh, $active);
        } while (    $mrc == CURLM_CALL_MULTI_PERFORM);
    }
    ?>
    up
    4
    Adam Richardson
    6 years ago
    One of the URLs used in the first example on this page (lxr.php.net) now gives a proxy error.

    If you're using this first script example, replace with a different URL.
    up
    -14
    hushuilong at gmail dot com
    13 years ago
    Simulate multiple threads request:
    <?php
    function multiple_threads_request($nodes){
                $mh = curl_multi_init();
                $curl_array = array();
            foreach(    $nodes as $i => $url)
            {
                    $curl_array[$i] = curl_init($url);
                    curl_setopt($curl_array[$i], CURLOPT_RETURNTRANSFER, true);
                    curl_multi_add_handle($mh, $curl_array[$i]);
            }
                $running = NULL;
            do {
                    usleep(10000);
                    curl_multi_exec($mh,$running);
            } while(    $running > 0);
           
                $res = array();
            foreach(    $nodes as $i => $url)
            {
                    $res[$url] = curl_multi_getcontent($curl_array[$i]);
            }
           
            foreach(    $nodes as $i => $url){
                    curl_multi_remove_handle($mh, $curl_array[$i]);
            }
                curl_multi_close($mh);       
            return     $res;
    }
    print_r(muti_thread_request(array(
            'http://www.example.com',
            'http://www.example.net',
    )));
    ?>
    add a note add a note
    To Top