PHP Master | Utilisation de Curl pour les demandes distantes

Si vous êtes un utilisateur Linux, vous avez probablement utilisé Curl. C'est un outil puissant utilisé pour tout, de l'envoi d'e-mails au téléchargement des derniers sous-titres My Little Pony. Dans cet article, je vais expliquer comment utiliser l'extension Curl dans PHP. L'extension nous offre la fonctionnalité comme utilité console dans le monde confortable de PHP. Je vais discuter de l'envoi de demandes de GET et de publication, de gestion des cookies de connexion et des fonctionnalités FTP. Avant de commencer, assurez-vous que l'extension (et la bibliothèque Libcurl) sont installées. Il n'est pas installé par défaut. Dans la plupart des cas, il peut être installé à l'aide du gestionnaire de packages de votre système, mais à moins que vous puissiez trouver des instructions dans le manuel PHP.

Les plats clés

• Curl, un outil puissant utilisé pour une variété de tâches, de l'envoi d'e-mails aux sous-titres de téléchargement, peut être utilisé en PHP via une extension offrant la même fonctionnalité que l'utilitaire de console.
• Curl peut être utilisé pour récupérer les pages Web, se connecter aux sites Web, travailler avec FTP et envoyer plusieurs demandes. Par exemple, vous pouvez simuler la connexion à un site Web propulsé par WordPress en envoyant une demande de poste avec des détails spécifiques.
• Le dépannage des demandes de curl est simplifié avec l'utilisation de deux fonctions: curl_getInfo () et curl_error (). Ces fonctions fournissent des informations détaillées sur le canal et toutes les erreurs qui peuvent survenir pendant la demande.
• Curl est un outil efficace et puissant pour passer des appels distants, ce qui le rend idéal pour les tâches telles que l'accès aux API externes ou à ramper. Il offre une interface conviviale et une exécution relativement facile des demandes.

Comment ça marche?

Toutes les demandes de curl suivent le même modèle de base:

1. Nous initialisons d'abord la ressource CURL (souvent abrégée en tant que ch pour «manche de curl») en appelant la fonction curl_init ().
2. Ensuite, nous définissons diverses options, telles que l'URL, la méthode de demande, les données de charge utile, etc.
Ensuite, nous exécutons la demande en appelant curl_exec ().
Enfin, nous libérons la ressource pour effacer la mémoire.
Ainsi, le code de passe-partout pour faire une demande ressemble à ceci:

La seule chose qui modifie la demande est quelles options sont définies, ce qui dépend bien sûr de ce que vous faites avec Curl.

<span><span><?php
</span></span><span><span>// init the resource
</span></span><span><span>$ch = curl_init();
</span></span><span>
</span><span><span>// set a single option...
</span></span><span><span>curl_setopt($ch, OPTION, $value);
</span></span><span><span>// ... or an array of options
</span></span><span><span>curl_setopt_array($ch, array(
</span></span><span><span>OPTION1 => $value1,
</span></span><span><span>OPTION2 => $value2
</span></span><span><span>));
</span></span><span>
</span><span><span>// execute
</span></span><span><span>$output = curl_exec($ch);
</span></span><span>
</span><span><span>// free
</span></span><span><span>curl_close($ch);</span></span>

Récupérer une page Web

L'exemple le plus élémentaire de l'utilisation de Curl à laquelle je peux penser est simplement de récupérer le contenu d'une page Web. Alors, récupérons la page d'accueil de la BBC à titre d'exemple.

Vérifiez la sortie dans votre navigateur et vous devriez voir le site Web de la BBC affiché. Nous avons de la chance car le site s'affiche correctement en raison de son lien absolu aux feuilles de style et aux images. Les options que nous venons d'utiliser étaient:

<span><span><?php
</span></span><span><span>curl_setopt_array(
</span></span><span><span>$ch, array(
</span></span><span><span>CURLOPT_URL => 'http://www.bbc.co.uk/',
</span></span><span><span>CURLOPT_RETURNTRANSFER => true
</span></span><span><span>));
</span></span><span>
</span><span><span>$output = curl_exec($ch);
</span></span><span><span>echo $output;</span></span>

curlopt_url - spécifie l'URL de la demande
• curlopt_returntransfer - Lors du défaut false, curl_exec () renvoie vrai ou faux selon le succès de la demande. Lorsqu'il est défini sur true, curl_exec () renvoie le contenu de la réponse.

Connectez-vous à un site Web

Curl a exécuté une demande GET pour récupérer la page BBC, mais Curl peut également utiliser d'autres méthodes, telles que Post et PUT. Pour cet exemple, simulons la connexion à un site Web alimenté par WordPress. La connexion est effectuée en envoyant une demande de poste à http://example.com/wp-login.php avec les détails suivants:

• Connexion - le nom d'utilisateur
• pwd - le mot de passe
• redirect_to - L'URL que nous voulons aller après la connexion
• testcookie - devrait être défini sur 1 (ce n'est que pour WordPress)

Bien sûr, ces paramètres sont spécifiques à chaque site. Vous devez toujours vérifier les noms d'entrée par vous-même, ce qui peut facilement être fait en visualisant la source d'une page HTML dans votre navigateur.

<span><span><?php
</span></span><span><span>// init the resource
</span></span><span><span>$ch = curl_init();
</span></span><span>
</span><span><span>// set a single option...
</span></span><span><span>curl_setopt($ch, OPTION, $value);
</span></span><span><span>// ... or an array of options
</span></span><span><span>curl_setopt_array($ch, array(
</span></span><span><span>OPTION1 => $value1,
</span></span><span><span>OPTION2 => $value2
</span></span><span><span>));
</span></span><span>
</span><span><span>// execute
</span></span><span><span>$output = curl_exec($ch);
</span></span><span>
</span><span><span>// free
</span></span><span><span>curl_close($ch);</span></span>

Les nouvelles options sont:

• curlopt_post - Définissez ceci si vous souhaitez envoyer une demande de message
• curlopt_postfields - Les données qui seront envoyées dans le corps de la demande
• curlopt_follocation - Si le réglage est vrai, Curl suivra les redirectes

Euh oh! Si vous testez ce qui précède, vous verrez un message d'erreur: «Erreur: les cookies sont bloqués ou non pris en charge par votre navigateur. Vous devez permettre aux cookies d'utiliser WordPress. » Ceci est normal, car nous devons faire fonctionner les cookies pour que les sessions fonctionnent. Nous le faisons en ajoutant deux autres options.

<span><span><?php
</span></span><span><span>curl_setopt_array(
</span></span><span><span>$ch, array(
</span></span><span><span>CURLOPT_URL => 'http://www.bbc.co.uk/',
</span></span><span><span>CURLOPT_RETURNTRANSFER => true
</span></span><span><span>));
</span></span><span>
</span><span><span>$output = curl_exec($ch);
</span></span><span><span>echo $output;</span></span>

Les nouvelles options sont:

• curlopt_cookiesession - Si réglé sur true, Curl commencera une nouvelle session de cookie et ignorera les cookies précédents
• curlopt_cookiejar - C'est le nom du fichier où Curl doit enregistrer les informations sur les cookies. Assurez-vous d'avoir les autorisations correctes pour écrire dans le fichier!

Maintenant que nous sommes connectés, nous devons seulement référencer le fichier de cookie pour les demandes ultérieures.

Travailler avec FTP

L'utilisation de Curl pour télécharger et télécharger des fichiers via FTP est également facile. Examinons le téléchargement d'un fichier:

<span><span><?php
</span></span><span><span>$postData = array(
</span></span><span><span>'login' => 'acogneau',
</span></span><span><span>'pwd' => 'secretpassword',
</span></span><span><span>'redirect_to' => 'http://example.com',
</span></span><span><span>'testcookie' => '1'
</span></span><span><span>);
</span></span><span>
</span><span><span>curl_setopt_array($ch, array(
</span></span><span><span>CURLOPT_URL => 'http://example.com/wp-login.php',
</span></span><span><span>CURLOPT_RETURNTRANSFER => true,
</span></span><span><span>CURLOPT_POST => true,
</span></span><span><span>CURLOPT_POSTFIELDS => $postData,
</span></span><span><span>CURLOPT_FOLLOWLOCATION => true
</span></span><span><span>));
</span></span><span>
</span><span><span>$output = curl_exec($ch);
</span></span><span><span>echo $output;</span></span>

Notez qu'il n'y a pas beaucoup de serveurs FTP publics qui permettent des téléchargements et des téléchargements anonymes pour des raisons de sécurité, de sorte que l'URL et les informations d'identification ci-dessus ne sont que des détenteurs de lieux. C'est presque la même chose que l'envoi d'une demande HTTP, mais seulement quelques différences mineures:

• curlopt_url - L'URL du fichier, notez l'utilisation de "ftp: //" au lieu de "http: //"
• curlot_userpwd - Les informations d'identification de connexion pour le serveur FTP

Le téléchargement d'un fichier via FTP est légèrement plus complexe, mais toujours géré. Cela ressemble à ceci:

<span><span><?php
</span></span><span><span>curl_setopt_array($ch, array(
</span></span><span><span>CURLOPT_URL => 'http://example.com/wp-login.php',
</span></span><span><span>CURLOPT_RETURNTRANSFER => true,
</span></span><span><span>CURLOPT_POST => true,
</span></span><span><span>CURLOPT_POSTFIELDS => $postData,
</span></span><span><span>CURLOPT_FOLLOWLOCATION => true,
</span></span><span><span>CURLOPT_COOKIESESSION => true,
</span></span><span><span>CUROPT_COOKIEJAR => 'cookie.txt'
</span></span><span><span>));</span></span>

Les options importantes ici sont:

• curlopt_upload - Boolean évident
• curlopt_infile - un flux lisible pour le fichier que nous voulons télécharger
• curlopt_infilesize - la taille du fichier que nous voulons télécharger en octets

Envoi de plusieurs demandes

Imaginez que nous devons effectuer cinq demandes pour récupérer toutes les données nécessaires. Gardez à l'esprit que certaines choses seront hors de notre contrôle, telles que la latence du réseau et la vitesse de réponse des serveurs cibles. Il devrait donc être évident que tout retard lors de la publication de cinq appels consécutifs peut vraiment s'additionner! Une façon d'atténuer ce problème consiste à émettre les demandes de manière asynchrone. Les techniques asynchrones sont plus courantes dans les communautés JavaScript et Node.js, mais brièvement au lieu d'attendre une tâche qui prend du temps, nous attribuons la tâche à un fil ou à un processus différent et continuons à faire d'autres choses en attendant. Une fois la tâche terminée, nous reviendrons pour son résultat. L'important est que nous n'avons pas perdu de temps à attendre un résultat; Nous l'avons passé à exécuter un autre code indépendamment. L'approche pour effectuer plusieurs demandes de boucles asynchrones est un peu différente d'AVANT. Nous commençons la même chose - nous inirions chaque canal, puis nous définissons les options - mais nous initissons ensuite un multi-handler à l'aide de curl_multi_init () et y ajoutons nos canaux avec Curl_Multi_Add_handle (). Nous exécutons les gestionnaires en les touchant et en vérifiant leur statut. En fin de compte, nous obtenons le contenu d'une réponse avec curl_multi_getContent ().

<span><span><?php
</span></span><span><span>// init the resource
</span></span><span><span>$ch = curl_init();
</span></span><span>
</span><span><span>// set a single option...
</span></span><span><span>curl_setopt($ch, OPTION, $value);
</span></span><span><span>// ... or an array of options
</span></span><span><span>curl_setopt_array($ch, array(
</span></span><span><span>OPTION1 => $value1,
</span></span><span><span>OPTION2 => $value2
</span></span><span><span>));
</span></span><span>
</span><span><span>// execute
</span></span><span><span>$output = curl_exec($ch);
</span></span><span>
</span><span><span>// free
</span></span><span><span>curl_close($ch);</span></span>

Le code ci-dessus a pris environ 1 100 ms pour exécuter sur mon ordinateur portable. Effectuer les demandes séquentiellement sans l'interface multi-interface, il a fallu environ 2 000 ms. Imaginez quel sera votre gain si vous envoyez des centaines de demandes! Il existe plusieurs projets qui résument et enveloppent la multi-interface. En discuter est au-delà de la portée de l'article, mais si vous prévoyez d'émettre plusieurs demandes de manière asynchrone, je vous recommande de les jeter un œil:

• github.com/petewarden/parallelcurl
• semLabs.co.uk/journal/object-orient-curl-class-with-multi-threading

Dépannage

Si vous utilisez CURL, vous effectuez probablement vos demandes à des serveurs tiers. Vous ne pouvez pas les contrôler et beaucoup peuvent se tromper: les serveurs peuvent être hors ligne, les structures de répertoires peuvent changer, etc. Nous avons besoin d'un moyen efficace de savoir ce qui ne va pas lorsque quelque chose ne fonctionne pas, et heureusement, Curl offre deux fonctions pour cela: curl_getInfo () et curl_error () . curl_getInfo () renvoie un tableau avec toutes les informations concernant la chaîne, donc si vous souhaitez vérifier si tout va bien, vous pouvez utiliser:

<span><span><?php
</span></span><span><span>// init the resource
</span></span><span><span>$ch = curl_init();
</span></span><span>
</span><span><span>// set a single option...
</span></span><span><span>curl_setopt($ch, OPTION, $value);
</span></span><span><span>// ... or an array of options
</span></span><span><span>curl_setopt_array($ch, array(
</span></span><span><span>OPTION1 => $value1,
</span></span><span><span>OPTION2 => $value2
</span></span><span><span>));
</span></span><span>
</span><span><span>// execute
</span></span><span><span>$output = curl_exec($ch);
</span></span><span>
</span><span><span>// free
</span></span><span><span>curl_close($ch);</span></span>

Si une erreur apparaît, vous pouvez le vérifier avec curl_error ():

<span><span><?php
</span></span><span><span>curl_setopt_array(
</span></span><span><span>$ch, array(
</span></span><span><span>CURLOPT_URL => 'http://www.bbc.co.uk/',
</span></span><span><span>CURLOPT_RETURNTRANSFER => true
</span></span><span><span>));
</span></span><span>
</span><span><span>$output = curl_exec($ch);
</span></span><span><span>echo $output;</span></span>

Conclusion

Curl offre un moyen puissant et efficace de passer des appels distants, donc si vous avez besoin d'un robot ou quelque chose pour accéder à une API externe, Curl est un excellent outil pour le travail. Il nous fournit une belle interface et un moyen relativement facile d'exécuter des demandes. Pour plus d'informations, consultez le manuel PHP et le site Web de Curl. Rendez-vous la prochaine fois! Les commentaires sur cet article sont fermés. Vous avez une question sur PHP? Pourquoi ne pas le demander sur nos forums? Image via Fotolia

Questions fréquemment posées (FAQ) sur l'utilisation de Curl pour les demandes distantes

Qu'est-ce que Curl et pourquoi est-il utilisé dans PHP?

CURL, ou URL client, est une bibliothèque qui vous permet de faire des demandes HTTP dans PHP. Il est utilisé pour communiquer avec différents types de serveurs et télécharger ou télécharger des données. Curl prend en charge divers protocoles comme HTTP, HTTPS, FTP, etc. C'est un outil puissant qui peut être utilisé pour interagir avec les API, gratter les pages Web ou même télécharger des fichiers.

Comment puis-je installer et activer Curl dans PHP?

Curl est généralement inclus dans la plupart serveurs Web. Cependant, s'il n'est pas activé, vous pouvez le faire en modifiant votre fichier php.ini. Localisez la ligne qui dit «; extension = curl» et retirez le point-virgule. Si la ligne n'existe pas, vous pouvez l'ajouter à la fin du fichier. Après avoir apporté des modifications, enregistrez le fichier et redémarrez votre serveur Web.

Comment faire une demande de boucle simple dans PHP?

Pour faire une simple demande de boucle, vous devez d'abord initialiser Curl avec la fonction curl_init (). Ensuite, définissez vos options à l'aide de la fonction curl_setopt (). Enfin, exécutez la demande avec curl_exec () et fermez la session avec curl_close (). Voici un exemple de base:

$ ch = curl_init ();
curl_setopt ($ ch, curlopt_url, "http://example.com");
curl_setopt ($ ch, curlopt_returntransfer, 1 );
$ output = curl_exec ($ ch);
curl_close ($ ch);

comment puis-je gérer les erreurs dans curl?

Vous pouvez gérer les erreurs dans Curl en utilisant le curl_errno () et curl_error ( ) fonctions. Ces fonctions renvoient respectivement le dernier numéro d'erreur et le message d'erreur. Voici un exemple:

if (curl_errno ($ ch)) {
echo 'error:'. curl_error ($ ch);
}

Comment envoyer une demande de post à l'aide de Curl?

Pour envoyer une demande de message, vous devez définir l'option Curlopt_Post à True et l'option curlopt_postFields sur un tableau de données que vous souhaitez envoyer. Voici un exemple:

curl_setopt ($ ch, curlopt_post, 1);
curl_setopt ($ ch, curlopt_postFields, "postvar1 = varie1 & postvar2 = value2");

comment définir personnalisé personnalisé personnalisé. en-têtes pour une demande de boucle?

Vous pouvez définir des en-têtes personnalisés en utilisant le Option Curlopt_httpheader. Cette option prend un tableau d'en-têtes comme valeur. Voici un exemple:

$ headers = array (
'contenu-type: application / json',
'Autorisation: Bearer'. $ Token
);
curl_setopt ($ ch, curlopt_httpheader, $ en-têtes);

comment suivre les redirections avec curl?

Pour suivre les redirections, vous devez définir l'option Curlopt_Follocation sur true. Voici comment vous pouvez le faire:

curl_setopt ($ ch, curlopt_follocation, true);

comment puis-je obtenir les en-têtes de réponse à partir d'une demande Curl?

pour que le En-têtes de réponse, vous pouvez définir l'option Curlopt_Header sur true. Cela comprendra les en-têtes dans la sortie. Voici un exemple:

curl_setopt ($ ch, curlopt_header, true);

comment envoyer un fichier à l'aide de curl?

Pour envoyer un fichier, vous pouvez utiliser le Curlopt_postFields Option et préfixez le chemin de fichier avec un symbole @. Voici un exemple:

curl_setopt ($ ch, curlopt_postfields, array ('file' => '@ / path / to / file.txt'));

comment utiliser curl avec Un proxy?

Pour utiliser Curl avec un proxy, vous pouvez définir l'option Curlopt_proxy à l'adresse du proxy. Voici comment vous pouvez le faire:

curl_setopt ($ ch, curlopt_proxy, "http://proxy.example.com:8080");

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!