POST-Anfragen in PHP mit cURL: Leitfaden 2025

PHP, cURL und HTTP POST: Daten wie ein Profi im Jahr 2025 versenden

Wenn Sie jemals PHP-Code geschrieben haben, der mit einem anderen Server "sprechen" musste – ein Formular absenden, eine API aufrufen oder einfach Daten übermitteln – sind Sie mit ziemlicher Sicherheit auf cURL gestoßen. Es ist nicht nur eine Bibliothek, es ist das Schweizer Taschenmesser für HTTP-Anfragen. Und obwohl wir im Jahr 2025 modernere Werkzeuge wie Guzzle oder Symfony HttpClient haben, bleibt cURL das Fundament, das jeder PHP-Entwickler kennen sollte.

Die Frage "PHP, cURL, and HTTP POST example?" hat auf Stack Overflow tausende Aufrufe. Warum? Weil es genau die Aufgabe ist, die in jedem zweiten Projekt vorkommt: von der Integration von Zahlungssystemen bis zum Senden von Daten an ein CRM. Lassen Sie uns klären, wie man das richtig, sicher und elegant macht.

Was ist cURL und warum braucht man es in PHP?

cURL (Client URL) ist eine leistungsstarke Bibliothek, die es Ihrem PHP-Skript ermöglicht, als HTTP-Client zu agieren. Stellen Sie sich vor, Ihr Code ist ein Browser ohne Benutzeroberfläche. Er kann Seiten öffnen, Formulare absenden, Dateien herunterladen und sogar mit Cookies arbeiten.

Im Jahr 2025 ist cURL immer noch relevant, weil:

\n
• Es in PHP integriert ist (keine zusätzlichen Pakete nötig)
\n
• Es schneller arbeitet als einige "schwere" Bibliotheken
\n
• Es Ihnen die volle Kontrolle über jeden Aspekt der Anfrage gibt
\n
• Es alle modernen Protokolle unterstützt: HTTP/2, HTTPS, FTP und sogar IMAP
\n

Basisbeispiel: Eine POST-Anfrage mit cURL senden

Beginnen wir mit dem Klassiker. Hier ist ein minimaler funktionierender Code, der eine POST-Anfrage an einen Server sendet:

<?php\n// URL, an die die Daten gesendet werden\n$url = 'https://api.example.com/submit';\n\n// Zu sendende Daten (assoziierter Array)\n$postData = [\n    'name' => 'Max Mustermann',\n    'email' => 'max@example.com',\n    'message' => 'Hallo aus dem Jahr 2025!'\n];\n\n// cURL initialisieren\n$ch = curl_init($url);\n\n// Anfrageeinstellungen\ncurl_setopt_array($ch, [\n    CURLOPT_POST => true,                          // Dies ist eine POST-Anfrage\n    CURLOPT_POSTFIELDS => http_build_query($postData), // Daten im String-Format\n    CURLOPT_RETURNTRANSFER => true,                // Antwort als String zurückgeben\n    CURLOPT_HEADER => false,                       // Keine Header zurückgeben\n    CURLOPT_TIMEOUT => 30,                         // Timeout 30 Sekunden\n    CURLOPT_SSL_VERIFYPEER => true,                // SSL-Zertifikat prüfen\n]);\n\n// Anfrage ausführen\n$response = curl_exec($ch);\n\n// Auf Fehler prüfen\nif (curl_errno($ch)) {\n    echo 'cURL-Fehler: ' . curl_error($ch);\n} else {\n    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);\n    echo "HTTP-Statuscode: $httpCode\\n";\n    echo "Antworttext: $response";\n}\n\n// Verbindung schließen\ncurl_close($ch);\n?>

Beachten Sie http_build_query(). Diese praktische Funktion wandelt ein Array in einen URL-kodierten String um. Ohne sie könnte cURL die Daten falsch verarbeiten.

JSON statt Formulardaten senden

Im Jahr 2025 arbeiten die meisten APIs mit JSON, nicht mit klassischen POST-Formularen. So passen Sie unser Beispiel an:

<?php\n$url = 'https://api.example.com/v2/users';\n$jsonData = json_encode([\n    'username' => 'developer_2025',\n    'password' => 'geheimes_passwort',\n    'role' => 'admin'\n]);\n\n$ch = curl_init($url);\ncurl_setopt_array($ch, [\n    CURLOPT_POST => true,\n    CURLOPT_POSTFIELDS => $jsonData,  // Rohes JSON senden\n    CURLOPT_HTTPHEADER => [           // Wichtig: Header angeben\n        'Content-Type: application/json',\n        'Content-Length: ' . strlen($jsonData),\n        'Accept: application/json'\n    ],\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_TIMEOUT => 15,\n]);\n\n$response = curl_exec($ch);\n$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n\nif ($htt