User Guide

170 Chapter 2: ColdFusion Tags
cfftp
Description
Lets users implement File Transfer Protocol (FTP) operations.
Category
File management tags, Internet Protocol tags
Syntax
The tag syntax depends on the action attribute value. See the following sections:
• “cfftp: Opening and closing FTP server connections” on page 171
• “cfftp: Connection: File and directory operations” on page 174
• “cfftp action = "listDir"” on page 178
See also
cfhttp
, cfldap, cfmail, cfpop; “Performing file operations with cfftp” in Chapter 40,
“Interacting with Remote Servers,” in ColdFusion MX Developer’s Guide
History
ColdFusion MX 7: Added the result attribute for file and directory operations.
ColdFusion MX: Deprecated the
agentname attribute. It might not work, and might cause an
error, in later releases.
Usage
Use this tag to move files between a ColdFusion server and an FTP server.
This tag does not move files between a ColdFusion server and a client browser. You do this as
follows:
• To transfer files from a client to a ColdFusion server: cffile action = "upload"
• To transfer files from a ColdFusion server to a client: the cfcontent tag
Security settings
ColdFusion MX security settings can prevent the cfftp tag from executing. If you run
ColdFusion applications on a server that is used by multiple customers, consider the security of
the files that the customer can move. For more information, see the “Administering Security”
section of Configuring and Administering ColdFusion MX.