XII. CURL

PHP supporte libcurl , une librairie créée par Daniel Stenberg , qui vous permet de vous connecter de communiquer avec de nombreux serveurs , grâce à de nombreux protocoles . libcurl supporte actuellement les protocoles suivants : http , https , ftp , gopher , telnet , dict , file , et ldap . libcurl supporte aussi les certificats HTTPS , les POST HTTP , PUT HTTP , le chargement par FTP ( ce qui peut être fait par l'extension FTP) , les chargement par formulaire HTTP , les proxies , les cookies et l 'authentification par mot de passe et nom de compte .

Pour pouvoir utiliser les fonctions CURL , vous devez installer le package CURL . PHP requiert la version CURL 7.0.2-beta ou plus récente . PHP ne fonctionnera pas avec une version inférieure à la version 7.0.2-beta .

Pour utiliser CURL depuis les scripts PHP , vous devez aussi compiler PHP avec l' option --with-curl[=DIR ] DIR est le chemin jusqu 'au dossier contenant les dossiers lib et include . Dans le dossier include il doit se trouver un dossier appelé curl , qui contient notamment les fichiers easy.h et curl.h . Il doit aussi se trouver un fichier nommé libcurl.a dans le dossier lib .

Une fois que vous avez compilé PHP avec le support CURL , vous pouvez commencer à l ' exploiter avec vos scripts PHP . Le principe de fonctionnement est d' initialiser une session CURL avec curl_init( ) , puis de choisir toutes vos options de transfert avec curl_exec( ) et de finir votre session avec curl_close( ) . Voici un exemple d ' utilisation des fonctions CURL , qui récupère la page principale de PHP :

Exemple 1 . Utilisation de CURL et PHP pour récupérer une page

 
?php

 
$ch

 
=

 
curl_init

 
(

 
"http

 
:

 
/

 
/www.php.net

 
/

 
")

 
;

 
$fp

 
=

 
fopen

 
("php_homepage.txt"

 
,

 
"w")

 
;

 
curl_setopt

 
($ch

 
,

 
CURLOPT_INFILE

 
,

 
$fp)

 
;

 
curl_setopt

 
($ch

 
,

 
CURLOPT_HEADER

 
,

 
0)

 
;

 
curl_exec

 
($ch)

 
;

 
curl_close

 
($ch)

 
;

 
fclose

 
($fp)

 
;

 
?





Table des matières
curl_close -- Ferme une session CURL
curl_errno -- Return an integer containing the last error number
curl_error -- Return a string containing the last error for the current session
curl_exec -- Exécute une session CURL
curl_getinfo -- Get information regarding a specific transfer
curl_init -- Initialise une session CURL
curl_setopt -- Modifie une option de transfert CURL
curl_version -- Retourne la version courante de CURL