Tutorial - Wie frage ich in PHP eine Seite mit curl ab?

Von Veröffentlicht am

Wer in PHP eine Seite mit curl abfragt, holt fremde Inhalte direkt auf den eigenen Server: Wetterdaten, Preise, Statusmeldungen oder die Antwort einer Schnittstelle. Diese Anleitung zeigt, wie Sie die Erweiterung prüfen, eine Anfrage sicher aufbauen und Fehler sauber abfangen.

curl auf dem Server prüfen

curl ist eine Erweiterung von PHP und bei fast allen Webspaces bereits aktiv. Ob das auch bei Ihnen gilt, zeigt ein kurzer Test:

<?php
echo function_exists('curl_init') ? 'curl ist aktiv' : 'curl fehlt';
?>

Fehlt die Erweiterung in einer lokalen Installation wie XAMPP, entfernen Sie in der php.ini das Semikolon vor der Zeile extension=curl und starten den Webserver neu. Details zur Einrichtung beschreibt das PHP-Handbuch unter https://php.net/manual/de/curl.setup.php. Auf einem Linux-Server installiert meist das Paket php-curl die Erweiterung nach.

Eine Seite mit curl abfragen: die drei Schritte

Jede Abfrage folgt demselben Muster: Verbindung vorbereiten, Optionen setzen, Anfrage ausführen. Die Grafik zeigt den Ablauf einschließlich der Prüfung am Ende:

Ablauf einer curl-Anfrage in PHP: Verbindung vorbereiten, Optionen setzen, Anfrage über HTTPS senden, Antwort prüfen und entweder verarbeiten oder bei einem Fehler einen Ersatzinhalt zeigen

Im Code sieht das so aus. Die Adresse ist ein Platzhalter, den Sie durch die gewünschte Seite ersetzen:

<?php
$ch = curl_init('https://example.com/');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,  // Antwort als Text zurückgeben
    CURLOPT_FOLLOWLOCATION => true,  // Weiterleitungen folgen
    CURLOPT_CONNECTTIMEOUT => 5,     // max. 5 Sekunden für den Aufbau
    CURLOPT_TIMEOUT        => 10,    // max. 10 Sekunden insgesamt
    CURLOPT_USERAGENT      => 'MeinSkript/1.0',
]);

$antwort = curl_exec($ch);
?>

Die wichtigste Option ist CURLOPT_RETURNTRANSFER. Ohne sie gibt curl die fremde Seite sofort ungefiltert aus, statt sie in $antwort zu speichern. Die beiden Zeitlimits sorgen dafür, dass Ihre eigene Seite nicht hängen bleibt, wenn der andere Server nicht antwortet. Ein Aufruf von curl_close() ist seit PHP 8 nicht mehr nötig, weil PHP die Verbindung selbst freigibt.

Fehler erkennen und behandeln

Nach der Anfrage gibt es zwei Arten von Fehlern. Entweder kam gar keine Verbindung zustande, dann liefert curl_exec() den Wert false. Oder der Server hat geantwortet, aber mit einem Fehlercode wie 404 oder 500. Beides prüfen Sie direkt danach:

<?php
if ($antwort === false) {
    echo 'Verbindung fehlgeschlagen: ' . curl_error($ch);
} elseif (curl_getinfo($ch, CURLINFO_HTTP_CODE) !== 200) {
    echo 'Die Seite ist gerade nicht verfügbar.';
} else {
    echo strlen($antwort) . ' Zeichen empfangen.';
}
?>

Zeigen Sie Ihren Besuchern bei einem Fehler einen Ersatzinhalt statt einer leeren Fläche, zum Beispiel den zuletzt gespeicherten Stand. Die genaue Fehlermeldung aus curl_error() gehört in ein Protokoll, nicht auf die öffentliche Seite.

Häufige Ursachen, wenn eine Seite mit curl nicht erreichbar ist: fehlende Zertifikate für HTTPS auf einem älteren Server, ein Webspace, der ausgehende Verbindungen sperrt, oder eine Gegenseite, die Anfragen ohne User-Agent ablehnt. Schalten Sie die Zertifikatsprüfung nie mit CURLOPT_SSL_VERIFYPEER ab, sondern lassen Sie das Zertifikatspaket beim Anbieter aktualisieren.

Die Antwort weiterverarbeiten

Liefert die Gegenseite JSON, etwa eine Wetter- oder Preisschnittstelle, wandelt json_decode() den Text in ein Array um:

<?php
$daten = json_decode($antwort, true);

if (is_array($daten)) {
    echo 'Temperatur: ' . $daten['temperatur'] . ' Grad';
}
?>

Geben Sie fremde Inhalte nie ungeprüft aus. Text aus einer anderen Quelle sollte mit htmlspecialchars() maskiert werden, bevor er auf Ihrer Seite erscheint. Und fragen Sie dieselbe Quelle nicht bei jedem Seitenaufruf neu ab: Eine Zwischenspeicherung für einige Minuten schont beide Server und macht Ihre Seite schneller.

Möchten Sie das Thema vertiefen, lesen Sie den Artikel „Daten von einer externen Webseite auslesen“. Dort werden die Daten mit fsockopen() abgeholt, ganz ohne die curl-Erweiterung.

Häufige Fragen zum Abfragen einer Seite mit curl

Ist curl in PHP enthalten?

Es ist eine Erweiterung. Auf den meisten Servern ist sie aktiv, lokal schalten Sie sie in der php.ini frei.

Wie bekomme ich die Antwort in eine Variable?

Mit der Option CURLOPT_RETURNTRANSFER. Ohne sie wird die Antwort direkt ausgegeben.

Was mache ich bei einer Zeitüberschreitung?

Zeitlimits mit CURLOPT_CONNECTTIMEOUT und CURLOPT_TIMEOUT setzen und im Skript einen Ersatzinhalt vorsehen.

Brauche ich noch curl_close()?

Nein, seit PHP 8 gibt PHP die Verbindung selbst frei. Ab PHP 8.5 ist die Funktion sogar als veraltet markiert.

Geht das auch ohne curl?

Für einfache Abrufe genügt file_get_contents(), sofern der Server Adressen dort erlaubt. curl bietet mehr Kontrolle über Zeitlimits und Fehler.

Jetzt die Abfrage in eine eigene Funktion auslagern – so bleibt der Aufruf an einer Stelle. Grundlagen liefern Typen in PHP und IF-Anweisungen für die Fehlerbehandlung.