Die von Daniel Stenberg erstellte libcurl-Bibliothek, die auf PHP basiert, ermöglicht Ihnen die Verbindung und Kommunikation mit einer Vielzahl von Servern über verschiedene Protokolltypen.
libcurl unterstützt derzeit die Protokolle http, https, ftp, gopher, telnet, dict, file und ldap. libcurl unterstützt außerdem HTTPS-Authentifizierung, HTTP POST, HTTP PUT, FTP-Upload (dies kann auch über die FTP-Erweiterung von PHP erfolgen), HTTP-Formular-Upload, Proxy, Cookies und Benutzername + Passwort-Authentifizierung.
So verwenden Sie cURL zum Implementieren von Get- und Post-Anfragen in PHP
Diese Funktionen wurden in PHP 4.0.2 eingeführt.
Um die cURL-Funktionen von PHP nutzen zu können, müssen Sie das libcurl-Paket installieren.
PHP erfordert libcurl 7.0.2-beta oder höher. Um cURL mit PHP 4.2.3 verwenden zu können, müssen Sie libcurl Version 7.9.0 oder höher installieren. Ab PHP 4.3.0 müssen Sie libcurl Version 7.9.0 oder höher installieren. Ab PHP 5.0.0 müssen Sie Version 7.10.5 oder höher von libcurl installieren.
Um die cURL-Unterstützung von PHP zu nutzen, müssen Sie beim Kompilieren von PHP die Option --with-curl[=DIR] hinzufügen. DIR ist der Verzeichnispfad, der lib und include enthält. Im Include-Verzeichnis muss ein Ordner mit dem Namen „curl“ vorhanden sein, der „easy.h“ und „curl.h“ enthält. Im lib-Ordner sollte sich eine Datei mit dem Namen libcurl.a befinden. Für PHP 4.3.0 können Sie --with-curlwrappers so konfigurieren, dass cURL URL-Streams verwendet.
Hinweis: Win32-Benutzer sollten beachten, dass bei Verwendung dieses Moduls in einer Windows-Umgebung libeay32.dll und ssleay32.dll in dem in der Umgebungsvariablen PATH enthaltenen Verzeichnis abgelegt werden müssen. Verwenden Sie nicht libcurl.dll von der cURL-Website.
Diese Erweiterung definiert zwei Ressourcen: cURL-Handles und cURL-Batch-Handles.
Im Folgenden finden Sie eine Liste der PHP-cURL-Funktionen:
| Funktion | beschreiben |
|---|---|
| curl_close() | Schließen Sie eine cURL-Sitzung. |
| curl_copy_handle() | Kopiert ein cURL-Handle und alle seine Optionen. |
| curl_errno() | Gibt die letzte Fehlernummer zurück. |
| curl_error() | Gibt eine Zeichenfolge zurück, die den letzten Fehler für die aktuelle Sitzung schützt. |
| curl_escape() | Gibt die maskierte Zeichenfolge URL-codiert für die angegebene Zeichenfolge zurück. |
| curl_exec() | Führen Sie eine cURL-Sitzung aus. |
| curl_file_create() | Erstellen Sie ein CURLFile-Objekt. |
| curl_getinfo() | Rufen Sie Informationen zu einem cURL-Verbindungsressourcenhandle ab. |
| curl_init() | Initialisieren Sie eine cURL-Sitzung. |
| curl_multi_add_handle() | Fügen Sie der Curl-Batch-Sitzung ein separates Curl-Handle hinzu. |
| curl_multi_close() | Schließen Sie eine Reihe von cURL-Handles. |
| curl_multi_exec() | Führt eine Unterverbindung des aktuellen cURL-Handles aus. |
| curl_multi_getcontent() | Wenn CURLOPT_RETURNTRANSFER festgelegt ist, wird der Textstrom der abgerufenen Ausgabe zurückgegeben. |
| curl_multi_info_read() | Rufen Sie die relevanten Transportinformationen der aktuell analysierten cURL ab. |
| curl_multi_init() | Gibt ein neues cURL-Batch-Handle zurück. |
| curl_multi_remove_handle() | Entfernen Sie eine Handle-Ressource aus der Curl-Batch-Handle-Ressource. |
| curl_multi_select() | Warten Sie in allen cURL-Batches auf aktive Verbindungen. |
| curl_multi_setopt() | Legen Sie eine Batch-CURL-Übertragungsoption fest. |
| curl_multi_strerror() | Gibt einen Zeichenfolgentext zurück, der den Fehlercode beschreibt. |
| curl_pause() | Verbindungen unterbrechen und fortsetzen. |
| curl_reset() | Setzt alle Optionen für das Sitzungshandle von libcurl zurück. |
| curl_setopt_array() | Legen Sie Optionen für cURL-Übertragungssitzungen in großen Mengen fest. |
| curl_setopt() | Legen Sie eine cURL-Transportoption fest. |
| curl_share_close() | Schließen Sie das gemeinsame cURL-Handle. |
| curl_share_init() | Initialisieren Sie das gemeinsame cURL-Handle. |
| curl_share_setopt() | Legen Sie cURL-Transportoptionen für ein gemeinsames Handle fest. |
| curl_strerror() | Gibt eine Zeichenfolgenbeschreibung des Fehlercodes zurück. |
| curl_unescape() | Dekodieren Sie die URL-codierte Zeichenfolge. |
| curl_version() | Informationen zur cURL-Version abrufen. |