Voir la source de Curl

J'aime beaucoup curl. Avant j'étais fan de [[wget]] mais finalement curl y'a que ça de vrai!

Un des problème que j'ai rencontré avec cet outil somme toute simple c'est la possibilité de sauvegarder les résultats dans un fichier ET de récupérer simplement le code retour HTTP. Si on utilise le standard -i pour avoir l'en-tête et qu'on utilise -o pour envoyer le résultat dans un fichier on se retrouve avec le header dans le fichier de sortie. Moi c'etait un ZIP ça posait des problèmes.

J'ai demandé a mon ami copilot et il m'a fait découvrir l'option -w. 

Le lui laisse prendre la suite. Il est plus sérieux que moi dans sa rédaction!

= Utilisation de l'option -w avec curl =

L'option <code>-w</code> (ou <code>--write-out</code>) de <code>curl</code> permet d'extraire des informations spécifiques sur la requête HTTP, comme le code de retour, le type de contenu, les temps de connexion, etc., ''sans affecter le fichier de sortie'' défini par <code>-o</code>.

== Syntaxe de base ==
<syntaxhighlight lang="bash">
curl -s -o out/parse.zip -w "%{http_code}\n" -F "file=@in/exemple.pdf" 'https://example.com/upload'
</syntaxhighlight>

* <code>-s</code> : mode silencieux (supprime la barre de progression).
* <code>-o out/parse.zip</code> : enregistre le corps de la réponse dans le fichier.
* <code>-w "%{http_code}\n"</code> : affiche le code HTTP à la fin, sans l'inclure dans le fichier.

== Variables disponibles avec -w ==
Voici quelques variables utiles que l'on peut inclure dans le format de sortie :

=== 📄 Statut HTTP ===
* <code>%{http_code}</code> : code de retour HTTP (ex. 200, 404)
* <code>%{response_code}</code> : identique à <code>http_code</code>
* <code>%{exitcode}</code> : code de sortie de curl
=== ⏱️ Temps ===
* <code>%{time_total}</code> : durée totale de la requête
* <code>%{time_connect}</code> : temps pour établir la connexion
* <code>%{time_starttransfer}</code> : temps jusqu’au premier octet reçu

=== 📦 Transfert ===
* <code>%{size_download}</code> : taille des données téléchargées
* <code>%{size_upload}</code> : taille des données envoyées
* <code>%{speed_download}</code> : vitesse de téléchargement

=== 🌐 Réseau ===
* <code>%{remote_ip}</code> : IP du serveur distant
* <code>%{remote_port}</code> : port du serveur distant
* <code>%{ssl_verify_result}</code> : résultat de la vérification SSL

=== 🧾 En-têtes ===
* <code>%{content_type}</code> : type MIME du contenu
* <code>%{redirect_url}</code> : URL de redirection (si applicable)
* <code>%{url_effective}</code> : URL finale après redirections

== Exemple complet ==
<syntaxhighlight lang="bash">
curl -s -o out/parse.zip -w "Code HTTP: %{http_code}\nType: %{content_type}\nDurée: %{time_total}s\n" \
     -F "file=@in/PE.pdf" 'https://example.com/upload'
</syntaxhighlight>

== Astuce : rediriger la sortie -w dans un fichier séparé ==
<syntaxhighlight lang="bash">
curl -s -o out/parse.zip -w "%{http_code}\n" -F "file=@in/PE.pdf" 'https://example.com/upload' > out/status.log
</syntaxhighlight>

Cela permet de garder le fichier téléchargé propre, tout en enregistrant les métadonnées dans un fichier à part.

== Conclusion ==
L'option <code>-w</code> est idéale pour automatiser les traitements HTTP avec <code>curl</code>, en extrayant des informations utiles sans interférer avec le contenu téléchargé via <code>-o</code>.