terminal Créateur de Commande curl star

Une brève histoire de curl

curl a été créé en 1998 par le développeur suédois Daniel Stenberg, qui en a écrit la première version pour récupérer automatiquement des taux de change pour un bot IRC sur un canal de discussion suédois — un petit besoin personnel, pas un grand projet d'infrastructure. Les gens ont continué à demander davantage de protocoles et d'options, et ce petit utilitaire est devenu un outil en ligne de commande généraliste pour transférer des données via HTTP, HTTPS, FTP puis, avec le temps, des dizaines d'autres protocoles. Stenberg est resté le mainteneur principal de curl pendant pratiquement toute son existence ; aujourd'hui, curl est installé par défaut sur macOS, sur pratiquement toutes les distributions Linux et, depuis 2018, sur Windows 10 et versions ultérieures ; on estime qu'il fonctionne sur des milliards d'appareils dans le monde, des routeurs aux voitures en passant par les consoles de jeu et presque tous les pipelines d'intégration continue qui communiquent avec une API. Ce qui a commencé comme la solution à un problème personnel très restreint est aujourd'hui, sans doute, le client HTTP en ligne de commande le plus largement déployé qui existe, et l'un des logiciels open source dont l'internet dépend le plus discrètement.

Comprendre les options générées par cet outil

Par défaut, curl ne suit pas les redirections HTTP. Si un serveur répond avec un statut 301 ou 302 et un en-tête Location pointant ailleurs, curl seul affiche cette réponse de redirection — ou un corps vide — puis s'arrête ; il ne poursuit pas automatiquement la nouvelle URL comme le fait silencieusement un navigateur web. Cela déroute un très grand nombre d'utilisateurs novices de curl : une URL qui fonctionne parfaitement dans un navigateur renvoie une réponse confuse, vide ou incorrecte depuis curl, sans raison apparente, simplement parce que le navigateur a suivi une redirection que curl n'a pas suivie. La solution est l'option -L (--location), qui indique à curl de suivre la chaîne de redirections jusqu'à sa destination finale. C'est un besoin si courant que de nombreux ingénieurs ajoutent -L par défaut chaque fois qu'ils ne testent pas délibérément le comportement des redirections lui-même.

Dès qu'une commande inclut des en-têtes ou un corps contenant des espaces, des guillemets ou des caractères spéciaux du shell ($, &, ;, accents graves), la façon de les mettre entre guillemets cesse d'être cosmétique — elle fait toute la différence entre une requête qui fonctionne et une que le shell dénature avant même que curl ne la voie. Un en-tête comme Authorization: Bearer abc 123 saisi sans guillemets est scindé par le shell au niveau de l'espace, si bien que curl reçoit Authorization: et Bearer comme deux arguments distincts et cassés au lieu d'un seul. Entourer toute la valeur de guillemets simples indique au shell de traiter littéralement tout ce qui se trouve à l'intérieur, espaces compris — mais des guillemets simples ne peuvent pas contenir un caractère guillemet simple littéral, puisque c'est précisément ce caractère qui referme la citation. L'échappement standard pour ce cas consiste à fermer le guillemet, insérer un guillemet simple précédé d'une barre oblique inverse, puis rouvrir le guillemet : '\''. Cet outil applique automatiquement cet échappement à chaque valeur qu'il insère, de sorte que les en-têtes, le contenu du corps et les identifiants d'authentification contenant des espaces, des guillemets ou d'autres caractères spéciaux produisent toujours une commande qui s'exécute correctement — sans que vous ayez à mémoriser vous-même les règles d'échappement.