Section courante

A propos

Section administrative du site

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

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 !
  1. <cfhttp method="get" url="http://www.google.ca/" result="result">
  2. </cfhttp>
  3. <cfoutput>RESULTAT: #result.filecontent#</cfoutput>

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