MACROMEDIA COLDFUSION 4.5-CFML LANGUAGE, Reference

Page: 87 / 608

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.
Note
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.
CFFTP topics:
•
Establishing a Connection with CFFTP
•
File and Directory Operations with CFFTP
•
Accessing the Columns in a Query Object
•
CFFTP.ReturnValue Variable
•
Connection Caching
Establishing a Connection with CFFTP
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
Note
Changes to a cached connection, such as changing RETRYCOUNT or
TIMEOUT values, may require reestablishing the connection.
Syntax
<CFFTP ACTION="action"
USERNAME="name"
PASSWORD="password"
SERVER="server"
TIMEOUT="timeout in seconds"