Macromedia coldfusion 4.5-cfml language reference User Manual

Chapter 1:  ColdFusion Tags

63

CFFTP

CFFTP allows users to implement File Transfer Protocol operations. By default, CFFTP 
caches an open connection to an FTP server. 

The CFFTP tag is for moving files between a ColdFusion server and an 
FTP server. CFFTP cannot move files between a ColdFusion server and a 
browser (client). Use 

CFFILE

 ACTION="UPLOAD" to transfer files from 

the client to a ColdFusion server; use 

CFCONTENT

 to transfer files from a 

ColdFusion server to the browser.

Note also that ColdFusion Server Basic security settings may prevent CFFTP from 
executing. These settings are managed using the ColdFusion Administrator Basic 
Security page. In order for CFFTP to execute, CFObject needs to be enabled on the 
Basic Security page. If you write ColdFusion applications designed to run on a server 
that is used by multiple customers, you need to consider the security of the files that 
the customer can move. Please refer to Administering ColdFusion Server for more 
information about securing ColdFusion tags.

•

Establishing a Connection with CFFTP 

•

File and Directory Operations with CFFTP 

•

Accessing the Columns in a Query Object 

•

CFFTP.ReturnValue Variable 

•

Connection Caching 

Use this form of the CFFTP tag to establish a connection with an FTP server. 

If you use connection caching to an already active FTP connection, you don’t need to 
respecify the connection attributes:

•

USERNAME

•

PASSWORD

•

SERVER

Changes to a cached connection, such as changing RETRYCOUNT or 
TIMEOUT values, may require reestablishing the connection. 

<CFFTP ACTION="action"

USERNAME="name"
PASSWORD="password"
SERVER="server"
TIMEOUT="timeout in seconds"