10 Utilisation de la commande cURL avec un exemple en temps réel

Publié: 2015-02-12

cURL est un outil de ligne de commande pour obtenir ou envoyer des données à l'aide de la syntaxe URL.

Si vous travaillez en tant que développeur ou dans la fonction de support, vous devez être conscient de l' utilisation de la commande cURL pour dépanner les applications Web. cURL est un utilitaire multiplateforme que vous pouvez utiliser sous Windows, MAC et UNIX.

Voici quelques-unes des syntaxes les plus utilisées avec un exemple pour vous aider.

Vérifiez si vous pouvez vous connecter à l'URL

Si vous travaillez sur un système UNIX et que vous essayez de vous connecter à l'URL externe, la première chose à faire est de vérifier si vous pouvez accéder à l'URL via curl.

curl yoururl.com

Il ne lancera aucune sortie. Cependant, si le serveur ne peut pas se connecter, vous obtiendrez des erreurs telles que Impossible de résoudre l'hôte.

 [root@gf-lab tmp]# curl helloitdoesntexist.com curl: (6) Could not resolve host: helloitdoesntexist.com; Unknown error [root@gf-lab tmp]#

Enregistrer la sortie URL/URI dans un fichier

Si vous devez enregistrer le contenu de l'URL ou de l'URI dans un fichier spécifique, vous pouvez utiliser la syntaxe suivante

 curl https://yoururl.com > yoururl.html

ex:

 [root@gf-lab tmp]# curl https://gf.dev > /tmp/gfhtml % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 18557 0 18557 0 0 72565 0 --:--:-- --:--:-- --:--:-- 72772 [root@gf-lab tmp]#

L'exemple ci-dessus enregistrera tout le contenu de gf.dev dans /tmp/gf.html

Afficher l'en-tête de la demande et de la réponse

Si vous rencontrez des problèmes et souhaitez valider, vous obtenez l'en-tête de demande et de réponse attendu.

 curl -v yoururl.com

Ex:

 [root@gf-lab tmp]# curl -v https://geekflare.com * About to connect() to geekflare.com port 443 (#0) * Trying 104.25.134.107... * Connected to geekflare.com (104.25.134.107) port 443 (#0) * Initializing NSS with certpath: sql:/etc/pki/nssdb * CAfile: /etc/pki/tls/certs/ca-bundle.crt CApath: none * SSL connection using TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 * Server certificate: * subject: CN=ssl371609.cloudflaressl.com,OU=PositiveSSL Multi-Domain,OU=Domain Control Validated * start date: Nov 07 00:00:00 2019 GMT * expire date: May 15 23:59:59 2020 GMT * common name: ssl371609.cloudflaressl.com * issuer: CN=COMODO ECC Domain Validation Secure Server CA 2,O=COMODO CA Limited,L=Salford,ST=Greater Manchester,C=GB > GET / HTTP/1.1 > User-Agent: curl/7.29.0 > Host: geekflare.com > Accept: */* > < HTTP/1.1 200 OK < Date: Sat, 09 Nov 2019 19:41:37 GMT < Content-Type: text/html; charset=UTF-8 < Transfer-Encoding: chunked < Connection: keep-alive < Set-Cookie: __cfduid=d2ce6cd359ebc0b6eb5ff3a454ed042021573328497; expires=Sun, 08-Nov-20 19:41:37 GMT; path=/; domain=.geekflare.com; HttpOnly; Secure < Vary: Accept-Encoding < Link: <https://geekflare.com/wp-json/>; rel="https://api.w.org/" < Link: <https://geekflare.com/>; rel=shortlink < X-SRCache-Fetch-Status: HIT < X-SRCache-Store-Status: BYPASS < X-Frame-Options: SAMEORIGIN < X-Powered-By: EasyEngine v4.0.12 < Via: 1.1 google < CF-Cache-Status: DYNAMIC < Strict-Transport-Security: max-age=15552000; preload < X-Content-Type-Options: nosniff < Alt-Svc: h3-23=":443"; ma=86400 < Expect-CT: max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct" < Server: cloudflare < CF-RAY: 533243e4bcd4bbf4-LHR <

Télécharger à un taux limité

Si vous travaillez sur l'optimisation et souhaitez voir combien de temps cela prend pour télécharger à une vitesse particulière, vous pouvez :-

 curl –-limit-rate 2000B

Ex:

 curl –-limit-rate 2000B https://gf.dev

Utiliser un proxy pour se connecter

Très pratique si vous travaillez sur le serveur DMZ où vous devez vous connecter au monde extérieur à l'aide d'un proxy.

 curl --proxy yourproxy:port https://yoururl.com

URL de test avec en-tête d'injection

Vous pouvez utiliser curl en insérant un en-tête avec vos données pour tester ou résoudre le problème particulier. Voyons l'exemple suivant pour demander avec Content-Type.

 curl --header 'Content-Type: application/json' http://yoururl.com

En faisant ci-dessus, vous demandez à curl de transmettre Content-Type en tant qu'application/json dans l'en-tête de la requête.

Afficher uniquement l'en-tête de réponse

Si vous effectuez un dépannage et souhaitez vérifier rapidement l'en-tête de réponse, vous pouvez utiliser la syntaxe suivante.

 curl --head http://yoururl.com

Ex:

 [root@gf-lab tmp]# curl --head https://chandan.io HTTP/1.1 200 OK Date: Sat, 09 Nov 2019 19:51:23 GMT Content-Type: text/html Connection: keep-alive Set-Cookie: __cfduid=d3cb2c7b8e566ad99c870b0af12b0f1eb1573329083; expires=Sun, 08-Nov-20 19:51:23 GMT; path=/; domain=.chandan.io; HttpOnly X-GUploader-UploadID: AEnB2Uo96JhvJmR2zYUL-Ndh2ta3UD_ykQAB5C7O8cjZQhCf-GxHQ0MsodSzRnl3guSN3ywAYNjtWcPXfwDXjLg3bQ-P5vQMOA Expires: Sat, 09 Nov 2019 20:51:23 GMT Cache-Control: public, max-age=3600 Last-Modified: Mon, 06 Aug 2018 10:45:47 GMT x-goog-generation: 1533552347482034 x-goog-metageneration: 1 x-goog-stored-content-encoding: identity x-goog-stored-content-length: 24620 x-goog-hash: crc32c=DpDPAQ== x-goog-hash: md5=cIP/3rusdUx12Zla1kf1yA== x-goog-storage-class: MULTI_REGIONAL Accept-Ranges: bytes CF-Cache-Status: DYNAMIC Expect-CT: max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct" Server: cloudflare CF-RAY: 53325234dc2fbb9a-LHR [root@gf-lab tmp]#

Connectez l'URL HTTPS/SSL et ignorez toute erreur de certificat SSL

Lorsque vous essayez d'accéder à l'URL sécurisée du certificat SSL/TLS et que le certificat est incorrect ou que le CN ne correspond pas, vous obtenez l'erreur suivante.

 curl: (51) Unable to communicate securely with peer: requested domain name does not match the server's certificate.

Bonne nouvelle, vous pouvez demander à cURL d'ignorer l'erreur de certificat avec l'indicateur --insecure .

 curl --insecure https://yoururl.com

Connectez-vous en utilisant un protocole spécifique (SSL/TLS)

Très pratique pour tester si une URL particulière peut établir une liaison via un protocole SSL/TLS spécifique.

Pour se connecter à l'aide de SSL v3

 curl --sslv3 https://yoururl.com

et pour différentes versions de TLS

 curl --tlsv1 https://example.com curl --tlsv1.0 https://example.com curl --tlsv1.1 https://example.com curl --tlsv1.2 https://example.com curl --tlsv1.3 https://example.com

Télécharger le fichier depuis le serveur FTP

Vous pouvez également utiliser curl pour télécharger le fichier en spécifiant votre nom d'utilisateur et votre mot de passe.

 curl -u user:password -O ftp://ftpurl/style.css

Vous pouvez toujours utiliser " -v " avec n'importe quelle syntaxe pour imprimer en mode verbeux.

Utilisation de l'en-tête d'hôte

L'en-tête d'hôte est utile pour tester l'URL cible sur IP lorsque le contenu demandé n'est disponible que lorsque l'en-tête d'hôte correspond. Ou, si vous souhaitez tester l'application à l'aide de l'adresse IP/URL de l'équilibreur de charge.

 curl --header 'Host: targetapplication.com' https://192.0.0.1:8080/

Que diriez-vous d'utiliser cURL en ligne ?

Oui, c'est possible avec les outils suivants. Vous pouvez exécuter cURL à distance.

CURL en ligne - un outil léger pour récupérer l'URL en ligne et la possibilité d'ajouter les options suivantes.

 --connect-timeout --cookie --data --header --head --location --max-time --proxy --request --user --url --user-agent

Générateur de ligne de commande cURL - celui-ci est différent. Il vous aide à créer la commande curl où vous pouvez entrer des informations dans une belle interface utilisateur, et en bas, vous obtiendrez la commande cURL.

constructeur de boucles

cURL est un utilitaire utile pour résoudre un problème de connectivité en temps réel, et j'espère que ce qui précède vous aidera. Si vous souhaitez en savoir plus, je vous recommande le cours en ligne Linux Command Line Basics.