array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.curl-exec.php', 1 => 'curl_exec', 2 => 'Eine cURL-Session ausführen', ), 'up' => array ( 0 => 'ref.curl.php', 1 => 'cURL Funktionen', ), 'prev' => array ( 0 => 'function.curl-escape.php', 1 => 'curl_escape', ), 'next' => array ( 0 => 'function.curl-getinfo.php', 1 => 'curl_getinfo', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/curl/functions/curl-exec.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

Bei Erfolg sendet diese Funktion das Ergebnis direkt an stdout und gibt true zurück. Bei einem Fehler wird false zurückgegeben. Ist jedoch die Option CURLOPT_RETURNTRANSFER gesetzt 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

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

Beispiele

Beispiel #1 Abrufen einer Webseite

<?php
// Erzeuge ein neues 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);
?>

Siehe auch