View comments | RSS feed
Contents > CFML Reference > ColdFusion Tags > cffile action = "copy" PreviousNext

cffile action = "copy"

Copies a file from one directory to another on the server. 

<cffile 
   action = "copy"
   source = "full_path_name"
   destination = "full_path_name" 
   mode = "mode"
   attributes = "file_attributes_list">

cfdirectory

See the History section of the main cffile tag page.

Attribute

Req/Opt

Default

Description

action

Required

 

Type of file manipulation that the tag performs.

source

Required

 

Pathname of the file to copy.

If not an absolute path (starting a with a drive letter and a colon, or a forward or backward slash), it is relative to the ColdFusion temporary directory, which is returned by the GetTempDirectory function.

destination

Required

 

Pathname of a directory or file on web server where the file will be copied. If not an absolute path, it is relative to the source directory..

mode

Optional

 

Applies only to UNIX and Linux. Permissions. Octal values of Unix chmod command. Assigned to owner, group, and other, respectively. For example:

  • 644: Assigns read/write permission to owner; read permission to group and other
  • 777: Assigns read/write/execute permission to all

attributes

Optional

 

Applies to Windows. A comma-delimited list of attributes to set on the file.

If omitted, the file's attributes are maintained.

Each value must be specified explicitly. For example, if you specify attributes = "readOnly", all other attributes are overwritten.

  • readOnly
  • hidden
  • normal

This example copies the keymemo.doc file to the c:\files\backup\ directory:

<cffile action = "copy" 
source = "c:\files\upload\keymemo.doc" 
destination = "c:\files\backup\">
Contents > CFML Reference > ColdFusion Tags > cffile action = "copy" PreviousNext

ColdFusion 8 | ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX | Forums | Developer Center | Bug Reporting

Version 6.1

Comments are no longer accepted for ColdFusion MX 6.1. ColdFusion 8 is the current version.

Comments


badugi77 said on Oct 5, 2005 at 6:45 AM :
What about "nameconflict" attribute? Can we use it for action="copy"? If not, what is the destination folder has the same name of file? If we can use nameconflict, why is it missing in the list above?
stonecliz said on Oct 26, 2006 at 2:39 AM :
it will overwrite the original file if name conflicts

 

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/6.1/htmldocs/tags-p29.htm