CFFILE ACTION = "WRITE" | |
Description | |
Writes a text file on the server, based on dynamic content. You can create static HTML files from the content, or log actions in a text file. | |
Syntax<cffile action = "write" file = "full_path_name" output = "content" mode = "permission" addNewLine = "Yes" or "No" attributes = "file_attributes_list" charset = "charset_option" > |
|
See also | |
cfdirectory | |
History | |
See the History section of the main cffile tag page. | |
Example | |
This example creates a file with information a user entered in an HTML insert form:
<cffile action = "write" file = "c:\files\updates\#Form.UpdateTitle#.txt" output = "Created By: #Form.FullName# Date: #Form.Date# #Form.Content#"> |
|
If the user submitted a form with the following:
UpdateTitle = "FieldWork" FullName = "World B. Frueh" Date = "10/30/01" Content = "We had a wonderful time in Cambridgeport." |
|
ColdFusion would create a file named FieldWork.txt in the c:\files\updates\ directory and the file would contain the following text:
Created By: World B. Frueh Date: 10/30/01 We had a wonderful time in Cambridgeport. |
|
This example shows the use of the mode attribute for UNIX. It creates the file /tmp/foo with permissions rw-r--r-- (owner = read/write, group = read, other = read):
<cffile action = "write" file = "/tmp/foo" mode = 644> |
|
This example appends to the file and sets permissions to read/write (rw) for all:
<cffile action = "append" destination = "/home/tomj/testing.txt" mode = 666 output = "Is this a test?"> |
|
This example uploads a file and gives it the permissions owner/group/other = read/write/execute):
cffile action = "upload" fileField = "fieldname" destination = "/tmp/program.exe" mode = 777> |
ACTION | |
Required | |
Type of file manipulation that the tag performs. |
FILE | |
Required | |
Pathname of the file to write. 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. |
OUTPUT | |
Required | |
Content of the file to be created. |
MODE | |
Optional | |
Applies only to UNIX and Linux. Permissions. Octal values of Unix chmod command. Assigned to owner, group, and other, respectively. For example:
|
ADDNEWLINE | |
Optional | |
Default value: "Yes"
|
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.
|
CHARSET | |
Optional | |
Default value: "JVM default file character set."
The character encoding in which the file contents is encoded. The following list includes commonly used values:
For more information character encodings, see: www.w3.org/International/O-charset.html. |