Fonctions cURL de PHP
Aperçu
La bibliothèque libcurl créée par Daniel Stenberg, prise en charge par PHP, vous permet de vous connecter et de communiquer avec divers types de serveurs à l'aide de divers types de protocoles.
libcurl prend actuellement en charge les protocoles http, https, ftp, gopher, telnet, dict, file et ldap. libcurl prend également en charge l'authentification HTTPS, HTTP POST, HTTP PUT, le téléversement FTP (cela peut aussi être fait via l'extension FTP de PHP), le téléversement de formulaires HTTP, les proxies, les cookies et l'authentification par nom d'utilisateur + mot de passe.
Méthodes pour implémenter des requêtes Get et Post à l'aide de cURL en PHP
Ces fonctions ont été introduites dans PHP 4.0.2.
Exigences
Pour utiliser les fonctions cURL de PHP, vous devez installer le paquetlibcurl.
PHP nécessite libcurl 7.0.2-beta ou supérieur. Pour utiliser cURL dans PHP 4.2.3, vous devez installer libcurl 7.9.0 ou supérieur. À partir de PHP 4.3.0, vous devez installer libcurl 7.9.0 ou supérieur. À partir de PHP 5.0.0, vous devez installer libcurl 7.10.5 ou supérieur.
Installation
Pour utiliser la prise en charge de cURL par PHP, vous devez ajouter l'option --with-curl[=DIR] lors de la compilation de PHP, où DIR est le chemin du répertoire contenant lib et include. Dans le répertoire include, il doit y avoir un dossier nommé curl contenant easy.h et curl.h. Le dossier lib doit contenir un fichier nommé libcurl.a. Pour PHP 4.3.0, vous pouvez configurer --with-curlwrappers pour que cURL utilise les flux URL.
Remarque : note aux utilisateurs de Win32
Pour utiliser ce module dans l'environnement Windows, libeay32.dll et ssleay32.dll doivent être placés dans un répertoire inclus dans la variable d'environnement PATH. N'utilisez pas le libcurl.dll du site Web de cURL.
Types de ressources
Cette extension définit deux types de ressources : les identifiants cURL et les identifiants de lot cURL.
Fonctions cURL de PHP
Ce qui suit contient la liste des fonctions cURL de PHP :
| Fonction | Description |
|---|---|
| curl_close() | Ferme une session cURL. |
| curl_copy_handle() | Copie un handle cURL et toutes ses options. |
| curl_errno() | Retourne le numéro de la dernière erreur. |
| curl_error() | Retourne une chaîne contenant l'erreur la plus récente de la session actuelle. |
| curl_escape() | Retourne une chaîne échappée, en effectuant un encodage URL sur la chaîne donnée. |
| curl_exec() | Exécute une session cURL. |
| curl_file_create() | Crée un objet CURLFile. |
| curl_getinfo() | Obtient des informations sur un handle de ressource de connexion cURL. |
| curl_init() | Initialise une session cURL. |
| curl_multi_add_handle() | Ajoute un handle curl individuel à une session curl par lots. |
| curl_multi_close() | Ferme un ensemble de handles cURL. |
| curl_multi_exec() | Exécute les sous-connexions du handle cURL actuel. |
| curl_multi_getcontent() | Si CURLOPT_RETURNTRANSFER est défini, renvoie le flux texte de la sortie récupérée. |
| curl_multi_info_read() | Obtient les informations de transfert associées au cURL actuellement analysé. |
| curl_multi_init() | Renvoie un nouveau handle de lot cURL. |
| curl_multi_remove_handle() | Supprime une ressource de handle de la ressource de handle du lot curl. |
| curl_multi_select() | Attend toutes les connexions actives dans le lot cURL. |
| curl_multi_setopt() | Définit une option de transfert cURL par lot. |
| curl_multi_strerror() | Renvoie une chaîne de texte décrivant le code d'erreur. |
| curl_pause() | Met en pause et reprend une connexion. |
| curl_reset() | Réinitialise toutes les options du handle de session libcurl. |
| curl_setopt_array() | Définit par lot les options d'une session de transfert cURL. |
| curl_setopt() | Définit une option de transfert cURL. |
| curl_share_close() | Ferme un handle partagé cURL. |
| curl_share_init() | Initialise un handle partagé cURL. |
| curl_share_setopt() | Définit une option de transfert cURL pour un handle partagé. |
| curl_strerror() | Renvoie une description textuelle du code d'erreur. |
| curl_unescape() | Décode une chaîne encodée URL. |
| curl_version() | Obtient les informations de version de cURL. |