CFDIRECTORY | |||
Description
Manages interactions with directories. |
|||
Category
File management tags
If you put ColdFusion applications on a server that is used by multiple customers, you must consider the security of files and directories that could be uploaded or otherwise manipulated with this tag by unauthorized users. For more information about securing ColdFusion tags, see Administering ColdFusion MX. | |||
Syntax<cfdirectory action = "directory action" directory = "directory name" name = "query name" filter = "list filter" mode = "permission" sort = "sort specification" newDirectory = "new directory name"> | |||
See also
cffile |
|||
History
New in ColdFusion MX: On Windows, if cfdirectory action = "list", this tag does not return the directory entries "." (dot) or ".." (dot dot), which represent "the current directory" and "the parent directory." (In earlier releases, ColdFusion returned these entries.) New in ColdFusion MX:
<cfdirectory action = "list" directory ="c:\" name="foo> Files in c:\<br> <cfloop query = "foo" startrow = 3> #name#<br> > <cfdirectory directory="c:\" name="foo"> Files in c:\<br> <cfoutput query="foo"> <cfif NOT foo.name is "." AND NOT foo.name is ".."> #name#<br> </cfif> </cfoutput>
|
|||
Usage
If action = "list", cfdirectory returns these result columns, which you can reference in a cfoutput tag:
You can use the following result columns in standard CFML expressions, preceding the result column name with the query name: #mydirectory.name# #mydirectory.size# #mydirectory.type# #mydirectory.dateLastModified# #mydirectory.attributes# #mydirectory.mode# |
|||
Example <h3>cfdirectory Example</h3> <!--- use cfdirectory to give the contents of the snippets directory, order by name and size (you may need to modify this path) ---> <cfdirectory directory="#GetDirectoryFromPath(GetTemplatePath())#" name="myDirectory" sort="name ASC, size DESC"> <!---- Output the contents of the cfdirectory as a cftable -----> <cftable query="myDirectory" htmltable colheaders> <cfcol header="NAME:" text="#Name#"> <cfcol header="SIZE:" text="#Size#"> </cftable> |
ACTION | |
Optional | |
Default value: "List"
|
DIRECTORY | |
Required | |
Absolute pathname of directory against which to perform action. |
NAME | |
Required if action = "list" | |
Name for output record set. |
FILTER | |
Optional if action = "list" | |
File extension filter applied to returned names. For example: *.cfm. One filter can be applied. |
MODE | |
Optional | |
Used with action = "create". Permissions. Applies only to Solaris and HP-UX. Octal values of chmod command. Assigned to owner, group, and other, respectively. For example:
|
SORT | |
Optional; used if action = "list" | |
Default value: "ASC"
Query column(s) by which to sort directory listing. Delimited list of columns from query output. To qualify a column, use:
For example: sort = "dirname ASC, file2 DESC, size, datelastmodified" |
NEWDIRECTORY | |
Required if action = "rename" | |
New name for directory |