Convertir curl en ColdFusion

cfhttp est la balise et la fonction intégrée de ColdFusion pour effectuer des requêtes HTTP. Elle prend en charge GET, POST, PUT, DELETE et les téléchargements de fichiers avec une intégration native dans les portées de variables de ColdFusion. Aucune installation n'est nécessaire — elle fait partie du runtime ColdFusion/Lucee. curl2code génère du code cfhttp/CFML pour les conversions ColdFusion.

La balise cfhttp utilise le balisage CFML avec des attributs nommés — traditionnelle, verbeuse et lisible dans les fichiers de templates. La fonction cfhttp() utilise CFScript avec des arguments entre parenthèses : cfhttp(url=url, method="GET") — moderne et concise. Les deux compilent vers le même appel moteur. Utilisez CFScript pour la cohérence dans les projets ColdFusion modernes. Pour des choix de syntaxe similaires, voir curl vers PHP.

Ajoutez des en-têtes avec cfhttpparam type="header" name="Authorization" value="Bearer #token#". Pour l'authentification Basic, utilisez directement les attributs username et password sur cfhttp. ColdFusion gère automatiquement l'encodage Base64 pour l'authentification Basic. curl2code convertit les drapeaux d'authentification en CFML.

Utilisez cfhttpparam type="file" name="upload" file="#filePath#" pour les téléchargements de fichiers. Pour les champs de formulaire : cfhttpparam type="formfield" name="key" value="value". ColdFusion définit automatiquement le Content-Type multipart et les boundaries. curl2code gère les conversions de drapeaux -F.

Enveloppez dans un try/catch : try { httpResult = cfhttp(...); } catch(any e) { ... }. Vérifiez cfhttp.statusCode pour le statut HTTP et cfhttp.errorDetail pour les informations d'erreur. Les réponses non-2xx ne lèvent pas d'exception par défaut — vérifiez toujours le code d'état manuellement.

Utilisez deserializeJSON(cfhttp.fileContent) pour analyser le JSON en structures et tableaux ColdFusion. Pour envoyer du JSON : serializeJSON(data). Les fonctions JSON de ColdFusion gèrent automatiquement les structures imbriquées complexes, convertissant de manière transparente entre les types de données CFML et le JSON.

Passez le paramètre timeout : cfhttp(url=url, timeout=30). La valeur est en secondes. Il n'y a pas de mécanisme de retry intégré — implémentez-le avec une boucle et try/catch. Le timeout par défaut varie selon la version de ColdFusion/Lucee.

Passez les paramètres de proxy : cfhttp(url=url, proxyServer="proxy.host", proxyPort=8080). Pour l'authentification proxy, ajoutez les paramètres proxyUser et proxyPassword. curl2code convertit les drapeaux -x en paramètres de proxy CFML.

Convertissez une commande curl POST comme curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL en ColdFusion en utilisant curl2code. Le code généré utilise cfhttpparam type='body' value='#serializeJSON(data)#'. curl2code détecte automatiquement les drapeaux -d/--data avec du contenu JSON et définit l'en-tête Content-Type approprié dans le code cfhttp.

Passez curl -H "Authorization: Bearer YOUR_TOKEN" URL à curl2code et il générera le code cfhttp avec l'en-tête d'authentification : cfhttpparam type='header' name='Authorization' value='Bearer TOKEN'. curl2code détecte les jetons Bearer à partir des drapeaux -H "Authorization: Bearer ..." et --oauth2-bearer. Pour le Basic auth, utilisez -u user:pass.

curl2code convertit curl -H "Content-Type: application/json" URL en code cfhttp avec l'en-tête approprié : cfhttpparam type='header' name='Content-Type' value='application/json'. Pour les données -d, curl utilise par défaut application/x-www-form-urlencoded ; pour les téléchargements de formulaires -F, il utilise multipart/form-data. curl2code associe chacun à l'API cfhttp correcte.