curl_exec

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

    curl_exec — Eine cURL-Session ausführen

    Beschreibung

    curl_exec(CurlHandle$handle): string|bool

    Ausführen der übergegebenen cURL-Session.

    Diese Funktion sollte aufgerufen werden, nachdem eine cURL-Session initialisiert wurde und alle Optionen für jene gesetzt sind.

    Parameter-Liste

    handle

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

    Rückgabewerte

    Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben. Ist jedoch die Option CURLOPT_RETURNTRANSFERgesetzt so wird das Ergebnis des cURL-Transfers zurückgegeben, im Falle eines Fehlschlags false.

    Warnung

    Diese Funktion kann sowohl das boolsche false zurückliefern, als auch einen nicht-boolschen Wert, welcher zu false ausgewertet wird. Weitere Informationen entnehmen Sie bitte dem Abschnitt über die boolschen Typen. Benutzen Sie deshalb den === Operator, um den Rückgabewert dieser Funktion zu überprüfen.

    Hinweis:

    Es ist zu beachten, dass Antwort-Statuscodes, die Fehler anzeigen (wie etwa 404 Not found), nicht als Fehlschlag angesehen werden. curl_getinfo() kann verwendet werden, um auf solche zu prüfen.

    Changelog

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

    Beispiele

    Beispiel #1 Abrufen einer Webseite

    <?php
    // erzeuge einen neuen cURL-Handle
    $ch = curl_init();

    // setze die URL und andere Optionen
    curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
    curl_setopt($ch, CURLOPT_HEADER, 0);

    // führe die Aktion aus und gib die Daten an den Browser weiter
    curl_exec($ch);

    // schließe den cURL-Handle und gib die Systemresourcen frei
    curl_close($ch);
    ?>

    Siehe auch

    To Top