User Guide

Table Of Contents
996 Chapter 40: Interacting with Remote Servers
Using the cfhttp Post method
Use the Post method to send cookie, form field, CGI, URL, and file variables to a specified
ColdFusion page or CGI program for processing. For Post operations, you must use the
cfhttpparam tag for each variable you want to post. The Post method passes data to a specified
ColdFusion page or an executable that interprets the variables being sent and returns data.
For example, when you build an HTML form using the Post method, you specify the name of the
page to which form data is passed. You use the Post method in
cfhttp in a similar way. However,
with
cfhttp, the page that receives the Post does not, itself, display anything.
To pass variables to a ColdFusion page:
1.
Create a ColdFusion page with the following content:
<html>
<head>
<title>HTTP Post Test</title>
</head>
<body>
<h1>HTTP Post Test</h1>
<cfhttp method="Post"
url="http://127.0.0.1:8500/myapps/post_test_server.cfm">
<cfhttpparam type="Cookie"
value="cookiemonster"
name="mycookie6">
<cfhttpparam type="CGI"
value="cgivar "
name="mycgi">
<cfhttpparam type="URL"
value="theurl"
name="myurl">
<cfhttpparam type="Formfield"
value="twriter@macromedia.com"
name="emailaddress">
<cfhttpparam type="File"
name="myfile"
file="c:\pix\trees.gif">
</cfhttp>
<cfoutput>
File Content:<br>
#cfhttp.filecontent#<br>
Mime Type: #cfhttp.MimeType#<br>
</cfoutput>
</body>
</html>
2.
Replace the path to the GIF file to a path on your server (just before the closing cfhttp tag).
3.
Save the file as post_test.cfm in the myapps directory under your web_root.
Note: You must write a page to view the variables. This is the next procedure.