CFHTTP |
HTTP |
|---|---|
| ColdFusion (CFML) |
Syntaxe
|
<CFHTTP paramètres> ... </CFHTTP> |
Paramètres
| Nom | Description | |
|---|---|---|
| charset=characterEncoding | Ce paramètre de balise permet d'indiquer l'encodage de caractères de la requête, incluant la chaine de caractères de la requête URL, le formulaire, les données du fichier et la réponse. Voici les valeurs reconnus : | |
| Valeur | Description | |
| "big5" | Cette valeur indique un jeu de police de caractères de Taïwan et Hong Kong. | |
| "euc-cn" | Cette valeur indique un jeu de police de caractères Unix étendue pour le Chinois. | |
| "euc-jp" | Cette valeur indique un jeu de police de caractères Unix étendue pour le Japonais. | |
| "euc-kr" | Cette valeur indique un jeu de police de caractères Unix étendue pour la Corée | |
| "iso-2022-jp" | Cette valeur indique un jeu de police de caractères japonais. | |
| "iso-8859-1" | Cette valeur indique un jeu de police de caractères Latin-1 de l'ouest européen. | |
| "shift_jis" | Cette valeur indique un jeu de police de caractères pour le Japonais. | |
| "us-ascii" | Cette valeur indique un jeu de police de caractères ASCII américain de 7 bits. | |
| "utf-8" | Cette valeur indique un jeu de police de caractères Unicode de 8 bits. | |
| "utf-16" | Cette valeur indique un jeu de police de caractères Unicode de 16 bits | |
| "windows-1252" | Cette valeur indique un jeu de police de caractères Windows pour l'ouest. | |
| clientCert=filename | Ce paramètre de balise permet d'indiquer le chemin complet vers le format de fichier PKCS12 contenant le certificat client de la requête. | |
| clientCertPassword=password | Ce paramètre de balise permet d'indiquer le mot de passe utilisé pour décrypter le certificat client. | |
| method=methodName | Ce paramètre de balise permet d'indiquer le nom de la méthode de transmission des données. Les valeurs reconnus sont les suivantes : | |
| Valeur | Description | |
| DELETE | Cette valeur permet d'indiquer l'envoi d'une requête de suppression vers le serveur à l'URL spécifié. | |
| GET | Cette valeur permet d'indiquer une requête d'information avec la méthode «GET» vers le serveur. | |
| HEAD | Cette valeur permet d'indiquer une requête d'information sans envoyer le corps du message dans la réponse. | |
| OPTIONS | Cette valeur permet d'indiquer une requête d'informations à propos des options de communications disponible pour le serveur et l'URL spécifié. | |
| POST | Cette valeur permet d'indiquer l'envoi des informations vers le serveurs pour les traitements avec la méthode «POST». | |
| PUT | Cette valeur permet d'indiquer que la requête vers le serveur entrepose le message du corps à l'URL spécifié. | |
| TRACE | Cette valeur permet d'indiquer une requête «echo» vers le serveur recevant les entêtes HTTP et retourne à l'envoyeur la réponse du corps. | |
| password=password | Ce paramètre permet d'indiquer le mot de passe à utiliser pour l'authentification «Basic» vers le URL destinataire. | |
| path=path | Ce paramètre permet d'indiquer dans quel fichier doit être sauvegardé la réponse HTTP de cette balise. | |
| port=portNumber | Ce paramètre permet d'indiquer le numéro du port vers le serveur où est envoyé la requête. | |
| proxyPort=portNumber | Ce paramètre permet d'indiquer le numéro du port vers le serveur Proxy. | |
| proxyServer=hostName | Ce paramètre permet d'indiquer le nom de l'hôte ou l'adresse IP vers le serveur Proxy où la requête est envoyé. | |
| proxyUser=username | Ce paramètre permet d'indiquer le nom de l'utilisateur à fournir au serveur Proxy. | |
| proxyPassword=password | Ce paramètre permet d'indiquer le mot de passe à fournir au serveur Proxy. | |
| redirect="yes|no" | Ce paramètre permet d'indiquer s'il doit effectuer une redirection lors de la réception de la réponse selon les valeurs suivantes : | |
| Valeur | Description | |
| no | Cette valeur indiquer qu'il ne faut pas exécuter la redirection et retourner les informations de réponse dans la variable «cfhttp» ou l'exception avec erreur si le paramètre throwOnError contient la valeur «True». | |
| yes | Cette valeur indiquer qu'il faut effectuer une exécution de redirection vers la page spécifié. | |
| resolveURL="yes|no" | Ce paramètre permet d'indiquer s'il faut résoudre la réponse du corps. | |
| timeout=second | Ce paramètre permet d'indiquer le nombre de secondes au maximum où l'on peut attendre après la réponse. | |
| url=serverURL | Ce paramètre de balise permet d'indiquer l'adresse de la ressource de serveur doit gérer dans la requête. L'URL doit inclure un nom d'hôte ou une adresse IP. | |
| username=username | Ce paramètre permet d'indiquer l'utilisateur à utiliser pour l'authentification «Basic» vers le URL destinataire. | |
| userAgent=value | Ce paramètre permet d'indiquer l'agent utilisateur pour la requête d'entête. Voir le User-Agent: du protocole HTTP. | |
| ... | ... | |
Description
Cette balise procure une interface HTTP.
Remarques
- Si vous utilisez «ColdFusion» version 7, 8 ou 9 et que vous constater des problèmes avec les certificats «SSL», vous devriez envisager de migré vers la version 11. Il est connu que ces versions ont parfois des difficultés avec les certificats. Cependant, si vous ne pouvez pas mettre à jour la version de ColdFusion, vous devrez envisager d'utiliser une DLL comme celle de «CFX_HTTP5» de l'entreprise Adiabata.
- Il est préférable d'utiliser les paramètres «username» et «password» de la balise «CFHTTP» plutôt que de faire un accès direct dans l'URL sous le format «http://monutilisateur:motdepasse@www.monsiteweb.com/», car il est uniquement supporté dans certains contextes particuliers, il n'est pas garantie qu'il fonctionnera dans un autre environnement.
- Si vous faites appels à cette balise afin de demander des informations de d'autres serveurs de votre entreprise, il peut être judicieux d'indiquer un «useragent» différent (exemple «useragent="Application Business 1.0"») afin que vous puissiez distinguer votre application d'un programmeur effectuant des tests à l'aide d'un FireFox par exemple.
Exemple
L'exemple suivant permet d'afficher le contenu de la page d'accueil de Google qu'il transmettre par l'intermédiaire de la variable «result» :
Essayer maintenant !
Voir également
Langage de programmation - ColdFusion (CFML) - Référence des balises - CFHTTPPARAM
Langage de programmation - ColdFusion (CFML) - Référence des balises - CFFTP
Langage de programmation - ColdFusion (CFML) - Référence des balises - CFLDAP
Langage de programmation - ColdFusion (CFML) - Référence des balises - CFMAIL
Langage de programmation - ColdFusion (CFML) - Référence des balises - CFPOP
Dernière mise à jour : Dimanche, le 17 mai 2015