Allows you to list, create, delete or rename a directory in the server file system.

 <cfdirectory directory="." action="list|create|delete|rename">

 directoryList(".", false, " ");

cfdirectory Attribute Reference

action string
Default: list

Action to perform
  • list
  • create
  • delete
  • rename

directory string

Absolute pathname of directory against which to perform

name string

Name for output record set.

filter string

File extension filter applied to returned names. For
example: *.cfm. One filter can be applied.

mode string

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

sort string
Default: asc

Query column(s) by which to sort directory listing.
Delimited list of columns from query output.
  • asc
  • desc

newdirectory string

New name for directory.

recurse boolean
Default: false

Whether ColdFusion performs the action on subdirectories.
  • true
  • false

type string
Default: all

* file: includes only filenames.
* dir: includes only directory names.
* all: includes both filenames and directory names.
  • dir
  • file
  • all

listinfo string
Default: all

* all: includes all information in the result set.
* name: includes only filenames in the result set.
  • name
  • all

Examples sample code using the cfdirectory tag

List Files in Directory (Script Syntax)

Returns a query

myList = directoryList(expandPath("./"), false, "query");

Create a Directory (Script Syntax)


Delete a Directory (Script Syntax)

Directory Delete


Rename a Directory (Script Syntax)

directoryRename(expandPath("./my_directory"), expandPath("./new_driectory"));

List File in Directory (Tag Syntax)

Directory List

<cfdirectory action="list" directory="#expandPath("./")#" recurse="false" name="myList">

Create a Directory (Tag Syntax)

<cfdirectory action="create" directory="#expandPath("./new_directory")#">

Delete a Directory (Tag Syntax)

<cfdirectory action="delete" directory="#expandPath("./my_directory")#">

Rename a Directory (Tag Syntax)

<cfdirectory action="rename" directory="#expandPath("./my_directory")#" newdirectory="#expandPath("./new_directory")#">

Fork me on GitHub