marktplatz
php-resource

PHP Handbuch

cURL, Client URL Bibliothek-Funktionen
PHP Handbuch
ZurückWeiter

XVIII. cURL, Client URL Bibliothek-Funktionen

Einführung

PHP unterstützt libcurl, eine Bibiothek entwickelt von Daniel Stenberg, die es erlaubt sich mit Servern zu verbinden und über diverse Protokolle zu kommunizieren. Libcurl unterstützt zur Zeit folgende Protokolle: http, https, ftp, gopher, telnet, dict, file und ldap. Libcurl unterstützt des weiteren HTTPS Zertifikate, HTTP POST, HTTP PUT, und das hochladen von Dateien unter Benutzung des FTP Protokolls (ist auch unter Nuztung der FTP Erweiterung PHPs' möglich), HTTP Fomular basierende Uploads, Proxies, Cookies, und Benutzer/Passwort Authentifikation.

Diese Funktionen wurden in PHP 4.0.2 hinzugefügt.

Anforderungen

Um cURL Functionen nutzen zu können, muss man das cURL Packet installieren. PHP fordert cURL 7.0.2-beta oder neuer. PHP wird nicht mir einer Version älter als 7.0.2-beta laufen In PHP 4.2.3, wird cURL in der Version 7.9.0 oder höher vorausgesetzt. Bei PHP 4.3.0, wird die cURL Version 7.9.8 oder höher gebraucht. PHP 5.0.0 wird wahrscheinlich eine cURL Version neuer als 7.10.5 voraussetzen.

Installation

Um PHP mit cURL-Unterstützung nutzen zu können, muss man PHP mit der Option --with-curl[=DIR] kompilieren, wobei DIR das Verzeichnis angibt in dem sich die Bibiotheken und die Includedateien befinden. In dem "include" Verzeichnis sollte ein Unterverzeichnis mit dem Titel "curl" existieren, dass die Dateien easy.h und curl.h enthält . Zudem sollte eine Datei namens libcurl.a in dem "lib"-Verzeichnis sein. Ab PHP 4.3.0 kann man PHP mit der Option --with-curlwrappers konfigurieren, um cURL für URL-Streams nuzten zu können.

Anmerkung für Win32-Nutzer: Um dieses Modul in einer Windows-Umgebung nutzen zu können, müssen libeay32.dll und ssleay32.dll aus dem DLL-Verzeichnis des PHP/Win32 binary Packets in das SYSTEM32-Verzeichnis des Windows PC's kopiert werden. (z.B.: C:\WINNT\SYSTEM32 oder C:\WINDOWS\SYSTEM)

libcurl.dll von der CURL-Webseite wird nicht benötigt.

Resource Typen

Diese Erweiterung definiert zwei Resource-Typen, ein cUrl-Handle und ein cUrl-Multi-Handle.

Vordefinierte Konstanten

Siehe auch Vordefinierte Konstanten

Beispiele

Wenn PHP mit cURL-Unterstützung kompiliert und installiert ist, kann mit der Benutzung der cURL-Funktionen begonnen werden. Die Idee die hinter den Funktionen steckt, ist dass man mit Hilfe von curl_init() eine cURL-Session initialisiert, alle für den Transfer nötigen Optionen unter Verwendung von curl_setopt() setzt und dann die Session mittels curl_exec() ausführt, um dann schließlich curl_close() zur Beendigung der Session zu nutzen.

Folgendes Beispiel nutzt die cURL-Functionen, um die Homepage von example.com in eine Datei zu speichern:

Beispiel 1. Nutzung von PHP's cURL-Modul, um die Homepage von example.com herunterzuladen

<?php

//Die Session initialisieren
$ch = curl_init("http://www.example.com/");
$fp = fopen("example_homepage.txt", "w");

//Session Optionen setzen
curl_setopt($ch, CURLOPT_FILE, $fp);
curl_setopt($ch, CURLOPT_HEADER, 0);

//Ausführen der Aktionen
curl_exec($ch);

//Session beenden
curl_close($ch);
fclose($fp);
?>

Inhaltsverzeichnis
Konstanten -- Vordefinierte Konstanten
curl_close -- Eine cURL-Session beenden
curl_copy_handle --  Kopieren eines cURL-Handles inklusiver aller Voreinstellungen
curl_errno -- Gibt die letzte Fehlernummer zurück
curl_error --  Gibt eine Fehlermeldung als String zurück
curl_exec -- Eine cURL Session ausführen
curl_getinfo --  Informationen zu einem bestimmten Transfer abfragen
curl_init -- Eine cURL-Session initialisieren
curl_multi_add_handle --  Einen normalen cURL-Handle zu einem cURL Multi-handle hinzufügen
curl_multi_close --  Eine Gruppe von cURL-Handlern schließen
curl_multi_exec --  Die Unterverbindungen des cURL Handles' ausführen
curl_multi_getcontent --  Den Inhalt des cURL-Handles zurückgeben, falls CURLOPT_RETURNTRANSFER gesetzt ist
curl_multi_info_read --  Informationen über die aktuellen Transfers abfragen
curl_multi_init --  Gibt einen neuen cURL-Multi-Handle zurück
curl_multi_remove_handle --  Einen Multi-Handle von einer Handle-Gruppe entfernen
curl_multi_select --  Alle Sockets abfragen, die mit der cURL Erweiterung assoziiert sind und ausgewählt werden können
curl_setopt_array -- Mehrere Optionen für einen cURL-Transfer setzen
curl_setopt -- Eine Option für einen cURL Transfer setzen
curl_version -- Gibt die aktuelle cURL-Version zurück
ZurückZum AnfangWeiter
ctype_xdigitNach obenKonstanten


Anmerkungen zum PHP Handbuch
Neue Anmerkung schreiben
 

 
PHP-Index
  1. Einführung
  2. Installation und Konfiguration
  3. Sprachreferenz
  4. Sicherheit
  5. Features
  6. Funktionsreferenz
  7. PHP und Zend Engine Interna
  8. FAQ: Frequently Asked Questions
  9. Appendices

shophosting



 

Neuzugänge PHP MySQL Tutorials

Joomla! Starterhilfe

Dieses Tutorial begleitet Sie bei dem Einstieg in die Welt von dem CMS Joomla!.

17.01.2012 werninator | Kategorie: MySQL
Objektorientiertes Programmieren

Dieses Tutorial beschreibt sehr gut die Wirkunsweise von objektorientiertes Programmieren. Also bestens geeignet um das objektorientierte Programmieren zu verstehen.

07.12.2010 phpsven | Kategorie: PHP
Tutorials zu Facebook Anwendungen mit PHP

In mehreren Tutorials wird der Zugriff auf Facebook Daten mittels Graph API, FQL und REST API erklärt. Alle Codebeispiele liegen zum Ausprobieren in einem SVN, bzw. github Repository bereit.

06.12.2010 abouttheweb | Kategorie: PHP