Tutoriel sur la commande curl de Linux pour les débutants (5 exemples)

La commande curl est un outil puissant et polyvalent utilisé pour transférer des données vers ou depuis un serveur en utilisant divers protocoles, tels que HTTP, HTTPS, FTP, et plus encore. Elle signifie “Client URL” et est couramment utilisée pour les requêtes web, permettant aux utilisateurs de télécharger des fichiers, d’envoyer des données via des requêtes POST, et même d’interagir directement avec des API RESTful depuis la ligne de commande. La commande curl peut gérer une large gamme de tâches, des téléchargements de fichiers simples aux formulaires multipart complexes, et est souvent utilisée dans des scripts pour l’automatisation en raison de sa flexibilité et de sa capacité à fournir des sorties détaillées, ce qui en fait un utilitaire essentiel dans un environnement Linux.

Dans ce tutoriel, nous allons discuter de la commande curl qui, entre autres choses, vous permet de télécharger des éléments depuis le Web. Veuillez noter que les exemples discutés dans cet article ont été testés sur Ubuntu 24.04.

Commande curl de Linux

La commande curl vous permet de télécharger et de télécharger des données via la ligne de commande Linux. Voici sa syntaxe :

curl [options] [URL...]

Et voici ce que dit la page de manuel à propos de cette commande :

curl est un outil pour transférer des données d'un ou vers un serveur, en utilisant l'un des protocoles pris en charge (DICT, FILE, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMTP, SMTPS, TELNET et TFTP). La commande est conçue pour fonctionner sans interaction de l'utilisateur.

curl offre une multitude d'astuces utiles comme le support des proxies, l'authentification utilisateur, le téléchargement FTP, le POST HTTP, les connexions SSL, les cookies, la reprise de transfert de fichiers, Metalink, et plus encore. Comme vous le verrez ci-dessous, le nombre de fonctionnalités vous fera tourner la tête !

curl est alimenté par libcurl pour toutes les fonctionnalités liées au transfert. Voir libcurl(3) pour plus de détails.

Voici quelques exemples sous forme de questions-réponses qui devraient vous donner une meilleure idée de la façon dont curl fonctionne.

Q1. Comment fonctionne la commande curl ?

L’utilisation de base est assez simple - il suffit de passer l’URL en entrée à la commande curl et de rediriger la sortie vers un fichier.

Par exemple :

curl http://releases.ubuntu.com/24.04/ubuntu-24.04-desktop-amd64.iso.torrent > test.torrent

Notez que vous pouvez également utiliser l’option -o ici.

-o, --output 
Écrire la sortie dans  au lieu de stdout.

Revenons à notre exemple, alors que les données ont été téléchargées dans le fichier ‘test.torrent’ sur mon système, la sortie suivante a été produite sur la ligne de commande :

Voici ce que dit la page de manuel à propos de ce compteur de progression qui s’affiche dans la sortie :

curl affiche normalement un compteur de progression pendant les opérations, indiquant la quantité de données transférées, les vitesses de transfert et le temps estimé restant, etc.

curl affiche ces données sur le terminal par défaut, donc si vous invoquez curl pour effectuer une opération et qu'il est sur le point d'écrire des données sur le terminal, il désactive le compteur de progression car sinon cela mélangerait la sortie entre le compteur de progression et les données de réponse.

Si vous voulez un compteur de progression pour les requêtes HTTP POST ou PUT, vous devez rediriger la sortie de réponse vers un fichier, en utilisant la redirection shell (>), -o [file] ou similaire.

Ce n'est pas le même cas pour le téléchargement FTP car cette opération ne renvoie aucune donnée de réponse au terminal.

Si vous préférez une "barre" de progression au lieu du compteur régulier, -# est votre ami.

Q2. Comment faire en sorte que curl utilise le même nom de fichier de téléchargement ?

Dans l’exemple précédent, vous voyez que nous avons dû spécifier explicitement le nom du fichier téléchargé. Cependant, vous pouvez forcer curl à utiliser le nom du fichier téléchargé comme nom de fichier local. Cela peut être fait en utilisant l’option de ligne de commande -O.

curl -O http://releases.ubuntu.com/18.04/ubuntu-18.04-desktop-amd64.iso.torrent

Donc dans ce cas, un fichier nommé ‘ubuntu-18.04-desktop-amd64.iso.torrent’ a été produit dans la sortie sur mon système.

Q3. Comment télécharger plusieurs fichiers en utilisant curl ?

Ce n’est pas compliqué non plus - il suffit de passer les URLs de la manière suivante :

curl -O [URL1] -O [URL2] -O [URL3] ...

Par exemple :

curl -O http://releases.ubuntu.com/18.04/ubuntu-18.04-desktop-amd64.iso.torrent -O http://releases.ubuntu.com/18.04/ubuntu-18.04-live-server-amd64.iso.torrent

Voici la commande ci-dessus en action :

Vous pouvez donc voir que la progression du téléchargement pour les deux URLs a été affichée dans la sortie.

Q4. Comment résoudre le problème de ‘déplacé’ ?

Parfois, lorsque vous passez une URL à la commande curl, vous obtenez des erreurs comme “Déplacé” ou “Déplacé de façon permanente”. Cela se produit généralement lorsque l’URL d’entrée redirige vers une autre URL. Par exemple, vous ouvrez un site web, disons oneplus.com, et il redirige vers une URL pour votre pays d’origine (comme oneplus.in), donc vous obtenez une erreur comme suit :

Si vous voulez que curl suive la redirection, utilisez l’option de ligne de commande -L à la place.

curl -L http://www.oneplus.com

Q5. Comment reprendre un téléchargement à partir du point d’interruption ?

Parfois, un téléchargement est interrompu en cours de route. Donc, pour gagner du temps et des données, lorsque vous essayez à nouveau, vous pouvez vouloir qu’il commence à partir du point où il a été interrompu. Curl vous permet de faire cela en utilisant l’option de ligne de commande -C.

Par exemple :

curl -C - -O http://releases.ubuntu.com/18.04/ubuntu-18.04-desktop-amd64.iso

La capture d’écran suivante montre la commande curl reprenant le téléchargement après qu’il ait été interrompu.

Conclusion

Donc vous pouvez voir, la commande curl est un utilitaire utile si vous aimez télécharger des éléments via la ligne de commande. Nous n’avons qu’effleuré la surface ici, car l’outil offre beaucoup plus de fonctionnalités. Une fois que vous avez terminé de pratiquer les options de ligne de commande discutées dans ce tutoriel, vous pouvez vous rendre à la page de manuel de curl pour en savoir plus à son sujet.