PHP cURL-Funktionen
Übersicht
Die von Daniel Stenberg erstellte libcurl-Bibliothek, die von PHP unterstützt wird, ermöglicht es Ihnen, sich mit verschiedenen Arten von Servern über verschiedene Arten von Protokollen zu verbinden und zu kommunizieren.
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 PHPs FTP-Erweiterung erfolgen), HTTP-formularbasierten Upload, Proxys, Cookies und Benutzername + Passwort-Authentifizierung.
Methoden zum Implementieren von Get- und Post-Anfragen mit cURL in PHP
Diese Funktionen wurden in PHP 4.0.2 eingeführt.
Anforderungen
Um die cURL-Funktionen von PHP zu verwenden, müssen Sie daslibcurl-Paket installieren.
PHP erfordert libcurl 7.0.2-beta oder höher. Um cURL in PHP 4.2.3 zu verwenden, müssen Sie libcurl 7.9.0 oder höher installieren. Ab PHP 4.3.0 müssen Sie libcurl 7.9.0 oder höher installieren. Ab PHP 5.0.0 müssen Sie libcurl 7.10.5 oder höher installieren.
Installation
Um die cURL-Unterstützung von PHP zu verwenden, müssen Sie beim Kompilieren von PHP die Option --with-curl[=DIR] hinzufügen, wobei DIR der Verzeichnispfad ist, der lib und include enthält. Im include-Verzeichnis muss sich ein Ordner namens curl befinden, der easy.h und curl.h enthält. Der lib-Ordner sollte eine Datei namens libcurl.a enthalten. Für PHP 4.3.0 können Sie --with-curlwrappers konfigurieren, damit cURL URL-Streams verwendet.
Hinweis: Hinweis für Win32-Benutzer\nUm dieses Modul in der Windows-Umgebung zu nutzen, müssen libeay32.dll und ssleay32.dll in einem Verzeichnis abgelegt werden, das in der PATH-Umgebungsvariable enthalten ist. Verwenden Sie nicht die libcurl.dll von der cURL-Website.
Ressourcentypen
Diese Erweiterung definiert zwei Arten von Ressourcen: cURL-Handles und cURL-Batch-Handles.
PHP cURL-Funktionen
Das Folgende enthält die Liste der PHP-cURL-Funktionen:
| Funktion | Beschreibung |
|---|---|
| curl_close() | Schließt 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 Zeichenkette zurück, die den letzten Fehler der aktuellen Sitzung enthält. |
| curl_escape() | Gibt eine escapte Zeichenkette zurück und führt eine URL-Kodierung der angegebenen Zeichenkette durch. |
| curl_exec() | Führt eine cURL-Sitzung aus. |
| curl_file_create() | Erstellt ein CURLFile-Objekt. |
| curl_getinfo() | Ruft Informationen über einen cURL-Verbindungs-Ressourcen-Handle ab. |
| curl_init() | Initialisiert eine cURL-Sitzung. |
| curl_multi_add_handle() | Fügt einen einzelnen cURL-Handle zu einer cURL-Batch-Sitzung hinzu. |
| curl_multi_close() | Schließt eine Reihe von cURL-Handles. |
| curl_multi_exec() | Führt die Unterverbindungen des aktuellen cURL-Handles aus. |
| curl_multi_getcontent() | Wenn CURLOPT_RETURNTRANSFER gesetzt ist, gibt den Textstrom der abgerufenen Ausgabe zurück. |
| curl_multi_info_read() | Ruft die zugehörigen Übertragungsinformationen des aktuell geparsten cURL ab. |
| curl_multi_init() | Gibt ein neues cURL-Batch-Handle zurück. |
| curl_multi_remove_handle() | Entfernt eine Handle-Ressource aus der cURL-Batch-Handle-Ressource. |
| curl_multi_select() | Wartet auf alle aktiven Verbindungen im cURL-Batch. |
| curl_multi_setopt() | Legt eine Batch-cURL-Transferoption fest. |
| curl_multi_strerror() | Gibt einen Zeichenfolgentext zurück, der den Fehlercode beschreibt. |
| curl_pause() | Pausiert und setzt eine Verbindung fort. |
| curl_reset() | Setzt alle Optionen des libcurl-Sitzungshandles zurück. |
| curl_setopt_array() | Setzt Optionen für eine cURL-Übertragungssitzung stapelweise. |
| curl_setopt() | Setzt eine cURL-Übertragungsoption. |
| curl_share_close() | Schließt ein gemeinsam genutztes cURL-Handle. |
| curl_share_init() | Initialisiert ein gemeinsames cURL-Handle. |
| curl_share_setopt() | Legt eine cURL-Transferoption für ein gemeinsames Handle fest. |
| curl_strerror() | Gibt eine Beschreibung des Fehlercodes als Zeichenkette zurück. |
| curl_unescape() | Dekodiert eine URL-kodierte Zeichenkette. |
| curl_version() | Ruft cURL-Versionsinformationen ab. |