Eine cURL-Session ausführen

# curl_exec

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

curl_exec — Eine cURL-Session ausführen

### Beschreibung

function 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

- curl_multi_exec() - Führt die Unter-Verbindungen des cURL-Handles aus

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open