curl_setopt_array

    (PHP 5 >= 5.1.3, PHP 7, PHP 8)

    curl_setopt_array — Mehrere Optionen für einen cURL-Transfer setzen

    Beschreibung

    curl_setopt_array(CurlHandle$handle, array$options): bool

    Setzt mehrere Optionen für eine cURL-Session. Diese Funktion ist nützlich, um eine große Anzahl an Optionen zu setzen, ohne wiederholt curl_setopt() aufrufen zu müssen.

    Parameter-Liste

    handle

    Ein von curl_init() zurückgegebenes cURL-Handle.

    options

    Ein array das die zu setzenden Optionen und die entsprechenden Werte enthält. Die Array-Schlüssel sollten gültige curl_setopt()-Konstanten resp. deren Integer- Equivalent sein.

    Rückgabewerte

    Gibt true zurück, wenn alle Optionen erfolgreich gesetzt werden konnten. Konnte eine Option nicht gesetzt werden wird unmittelbar false zurückgegeben und alle folgenden Optionen im Parameter options werden ignoriert.

    Changelog

    VersionBeschreibung
    8.0.0handle erwartet nun eine CurlHandle-Instanz; vorher wurde eine Ressource erwartet.

    Beispiele

    Beispiel #1 Initialisierung einer cURL-Session und holen einer Webseite

    <?php
    // neues cURL-Handle erstellen
    $ch = curl_init();

    // URL und andere Optionen setzen
    $options = array(CURLOPT_URL => 'http://www.example.com/',
    CURLOPT_HEADER => false
    );

    curl_setopt_array($ch, $options);

    // URL holen und an der Browser weitergeben
    curl_exec($ch);

    // cURL-Handle schließen und Systemresourcen freigeben
    curl_close($ch);
    ?>

    Anmerkungen

    Hinweis:

    Analog zu curl_setopt() wird ein für CURLOPT_POST übergebenes Array als multipart/form-data, ein URL-kodierter String als application/x-www-form-urlencoded kodiert.

    Siehe auch

    To Top