cfdirectory

<cfdirectory 
directory = "directory name" 
action = "list|copy|create|delete|rename" 
destination = "full pathname" 
filter = "list filter" 
listInfo = "name|all" 
mode = "permission" 
name = "query name" 
newDirectory = "new directory name" 
recurse = "yes|no" 
sort = "sort specification" 
storeACL = "S3_premissions" 
storeLocation = "location" 
type = "file|dir|all">

<cfscript> 
    cfdirectory(directory = "directory name", action = "list|copy|create|delete|rename", destination = "full pathname", filter = "list filter", listInfo = "name|all", mode = "permission", name = "query name", newDirectory = "new directory name", recurse = "yes|no", sort = "sort specification", storeACL = "S3_premissions", storeLocation = "location", type = "file|dir|all") 
</cfscript>

<!---List all files in a directory--->
<cfdirectory action="list" directory="#expandPath("./")#" recurse="false" name="myList">
<cfdump var="#myList#">

<!--- creates a directory in the specified location --->
<cfdirectory action="create" directory="#expandPath("./myNewDir")#">

<!--- deletes a directory in the specified location --->
<cfdirectory action="delete" directory="#expandPath("./myNewDir")#">

<!--- creates and renames a directory in the specified location ---><cfdirectory action="create" directory="#expandPath("./myNewDir")#">
<cfdirectory action="rename" directory="#expandPath("./myNewDir")#" newdirectory="#expandPath("./myRenamedDir")#" >

<!--- Creates and copies a directory from one location to another --->
<cfdirectory action="create" directory="#expandPath("./myNewDir")#">
<cfdirectory action="copy" destination="#expandPath("././")#" directory="#expandPath("./myNewDir")#" >

<!--- EXAMPLE 1: Creating and Renaming 
Check that the directory exists to avoid getting a ColdFusion error message. ---> 
<cfset newDirectory = "otherNewDir"> 
<cfset currentDirectory = GetDirectoryFromPath(GetCurrentTemplatePath()) & "newDir"> 
<!--- Check whether the directory exists. ---> 
<cfif DirectoryExists(currentDirectory)> 
<!--- If yes, rename the directory. ---> 
<cfdirectory action = "rename" directory = "#currentDirectory#" 
newDirectory = "#newDirectory#" > 
<cfoutput> 
<p>The directory existed and the name has been changed to: #newDirectory#</p> 
</cfoutput> 
<cfelse> 
<!--- If no, create the directory. ---> 
<cfdirectory action = "create" directory = "#currentDirectory#" > 
<cfoutput><p>Your directory has been created.</p></cfoutput> 
</cfif> 

<!--- EXAMPLE 2: Deleting a directory 
Check that the directory exists and that files are not in the directory to avoid getting ColdFusion error messages. ---> 

<cfset currentDirectory = GetDirectoryFromPath(GetCurrentTemplatePath()) & "otherNewDir"> 
<!--- Check whether the directory exists. ---> 
<cfif DirectoryExists(currentDirectory)> 
<!--- If yes, check whether there are files in the directory before deleting. ---> 
<cfdirectory action="list" directory="#currentDirectory#" 
name="myDirectory"> 
<cfif myDirectory.recordcount gt 0> 
<!--- If yes, delete the files from the directory. ---> 
<cfoutput> 
<p>Files exist in this directory. Either delete the files or code 
something to do so.</P> 
</cfoutput> 
<cfelse> 
<!--- Directory is empty - just delete the directory. ---> 
<cfdirectory action = "delete" directory = "#currentDirectory#"> 
<cfoutput> 
<p>The directory existed and has been deleted.</P> 
</cfoutput> 
</cfif> 
<cfelse> 
<!--- If no, post message or do some other function. ---> 
<cfoutput><p>The directory did NOT exist.</p></cfoutput> 
</cfif> 
<!---EXAMPLE 3: List directories 
The following example creates both an array of directory names and a query that contains entries for the directories only. ---> 

<cfdirectory directory="C:/temp" name="dirQuery" action="LIST"> 

<!--- Get an array of directory names. ---> 
<cfset dirsArray=arraynew(1)> 
<cfset i=1> 
<cfloop query="dirQuery"> 
<cfif dirQuery.type IS "dir"> 
<cfset dirsArray[i]=dirQuery.name> 
<cfset i = i + 1> 
</cfif> 
</cfloop> 
<cfdump var="#dirsArray#"> 
<br> 
<!--- Get all directory information in a query of queries.---> 
<cfquery dbtype="query" name="dirsOnly"> 
SELECT * FROM dirQuery 
WHERE TYPE='Dir' 
</cfquery> 
<cfdump var="#dirsOnly#">

<h1>Log File Browser Demo</h1>

<p><strong>What This Demo Shows:</strong> How to list files in a directory and display file details.</p>
<hr>

<h2>Example 1: List All Files in Current Directory</h2>

<cftry>
    <!--- Get current directory --->
    <cfset currentDir = getDirectoryFromPath(getCurrentTemplatePath())>
    
    <!--- List all files in the current directory --->
    <cfdirectory 
        action="list" 
        directory="#currentDir#" 
        name="allFiles" 
        recurse="false">
    
    <p><strong>✓ Directory Listed Successfully</strong></p>
    <p>Directory: <cfoutput>#currentDir#</cfoutput></p>
    <p>Total Items: <cfoutput>#allFiles.recordCount#</cfoutput></p>
    
    <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse;">
        <tr style="background-color: ##f0f0f0;">
            <th>Name</th>
            <th>Type</th>
            <th>Size (bytes)</th>
            <th>Date Modified</th>
        </tr>
        <cfloop query="allFiles">
            <cfoutput>
                <tr>
                    <td>#allFiles.name#</td>
                    <td>#allFiles.type#</td>
                    <td>#allFiles.size#</td>
                    <td>#dateTimeFormat(allFiles.dateLastModified, "yyyy-mm-dd HH:nn:ss")#</td>
                </tr>
            </cfoutput>
        </cfloop>
    </table>
    
    <cfcatch type="any">
        <p><strong>✗ Error:</strong> <cfoutput>#cfcatch.message#</cfoutput></p>
        <cflog file="directory_errors" type="error" text="List error: #cfcatch.message#">
    </cfcatch>
</cftry>

<hr>

<h2>Example 2: Filter Specific File Types (CFM Files)</h2>

<cftry>
    <cfset currentDir = getDirectoryFromPath(getCurrentTemplatePath())>
    
    <!--- List only .cfm files --->
    <cfdirectory 
        action="list" 
        directory="#currentDir#" 
        name="cfmFiles" 
        filter="*.cfm">
    
    <p><strong>✓ Filtered List Retrieved</strong></p>
    <p>Found <cfoutput>#cfmFiles.recordCount#</cfoutput> CFM file(s)</p>
    
    <cfif cfmFiles.recordCount GT 0>
        <ul>
            <cfloop query="cfmFiles">
                <cfoutput>
                    <li>#cfmFiles.name# - #numberFormat(cfmFiles.size/1024, "0.00")# KB</li>
                </cfoutput>
            </cfloop>
        </ul>
    <cfelse>
        <p>No CFM files found.</p>
    </cfif>
    
    <cfcatch type="any">
        <p><strong>✗ Error:</strong> <cfoutput>#cfcatch.message#</cfoutput></p>
    </cfcatch>
</cftry>

<hr>

<h2>Example 3: Simulated Log File Display</h2>

<cftry>
    <!--- Create mock log file data --->
    <cfset mockLogs = [
        {name: "app-2024-11-07.log", type: "File", size: 45678, dateLastModified: now()},
        {name: "error-2024-11-07.log", type: "File", size: 12345, dateLastModified: dateAdd("h", -2, now())},
        {name: "api-2024-11-07.log", type: "File", size: 89012, dateLastModified: dateAdd("h", -5, now())},
        {name: "db-2024-11-07.log", type: "File", size: 34567, dateLastModified: dateAdd("h", -1, now())}
    ]>
    
    <p><strong>✓ Log Files (Simulated Data)</strong></p>
    <p>Showing recent application logs:</p>
    
    <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse;">
        <tr style="background-color: ##f0f0f0;">
            <th>Log File</th>
            <th>Size</th>
            <th>Last Modified</th>
            <th>Age</th>
        </tr>
        <cfloop array="#mockLogs#" index="logFile">
            <cfset ageHours = dateDiff("h", logFile.dateLastModified, now())>
            <cfoutput>
                <tr>
                    <td>#logFile.name#</td>
                    <td>#numberFormat(logFile.size/1024, "0.00")# KB</td>
                    <td>#dateTimeFormat(logFile.dateLastModified, "yyyy-mm-dd HH:nn:ss")#</td>
                    <td>#ageHours# hour(s) ago</td>
                </tr>
            </cfoutput>
        </cfloop>
    </table>
    
    <cfcatch type="any">
        <p><strong>✗ Error:</strong> <cfoutput>#cfcatch.message#</cfoutput></p>
    </cfcatch>
</cftry>

<hr>

<h2>Example 1: Create a Simple Backup Directory</h2>

<cftry>
    <cfset currentDir = getDirectoryFromPath(getCurrentTemplatePath())>
    <cfset backupDir = currentDir & "demo-backups">
    
    <!--- Check if directory exists --->
    <cfif NOT directoryExists(backupDir)>
        <!--- Create the directory --->
        <cfdirectory action="create" directory="#backupDir#">
        <p><strong>✓ Directory Created Successfully</strong></p>
        <cfoutput>
            <p>Created: #backupDir#</p>
        </cfoutput>
        <cflog file="backup_operations" type="information" text="Created backup directory: #backupDir#">
    <cfelse>
        <p><strong>ℹ Directory Already Exists</strong></p>
        <cfoutput>
            <p>Directory: #backupDir#</p>
        </cfoutput>
    </cfif>
    
    <cfcatch type="any">
        <p><strong>✗ Error Creating Directory:</strong></p>
        <cfoutput>
            <p>Message: #cfcatch.message#</p>
            <p>Detail: #cfcatch.detail#</p>
        </cfoutput>
        <cflog file="backup_errors" type="error" text="Failed to create directory: #cfcatch.message#">
    </cfcatch>
</cftry>

<hr>

<h2>Example 2: Create Date-Based Directory Structure</h2>

<cftry>
    <cfset currentDir = getDirectoryFromPath(getCurrentTemplatePath())>
    <cfset todayDate = now()>
    <cfset yearFolder = year(todayDate)>
    <cfset monthFolder = numberFormat(month(todayDate), "00")>
    <cfset dayFolder = numberFormat(day(todayDate), "00")>
    
    <!--- Build nested path: backups/2024/11/07 --->
    <cfset baseDir = currentDir & "demo-backups">
    <cfset yearPath = baseDir & "\" & yearFolder>
    <cfset monthPath = yearPath & "\" & monthFolder>
    <cfset dayPath = monthPath & "\" & dayFolder>
    
    <cfset dirsCreated = []>
    
    <!--- Create base directory --->
    <cfif NOT directoryExists(baseDir)>
        <cfdirectory action="create" directory="#baseDir#">
        <cfset arrayAppend(dirsCreated, "base directory")>
    </cfif>
    
    <!--- Create year directory --->
    <cfif NOT directoryExists(yearPath)>
        <cfdirectory action="create" directory="#yearPath#">
        <cfset arrayAppend(dirsCreated, "year directory (#yearFolder#)")>
    </cfif>
    
    <!--- Create month directory --->
    <cfif NOT directoryExists(monthPath)>
        <cfdirectory action="create" directory="#monthPath#">
        <cfset arrayAppend(dirsCreated, "month directory (#monthFolder#)")>
    </cfif>
    
    <!--- Create day directory --->
    <cfif NOT directoryExists(dayPath)>
        <cfdirectory action="create" directory="#dayPath#">
        <cfset arrayAppend(dirsCreated, "day directory (#dayFolder#)")>
    </cfif>
    
    <p><strong>✓ Date-Based Directory Structure Ready</strong></p>
    <cfoutput>
        <p>Full Path: #dayPath#</p>
        <p>Structure: backups\#yearFolder#\#monthFolder#\#dayFolder#\</p>
    </cfoutput>
    
    <cfif arrayLen(dirsCreated) GT 0>
        <p>Created the following:</p>
        <ul>
            <cfloop array="#dirsCreated#" index="dirItem">
                <cfoutput><li>#dirItem#</li></cfoutput>
            </cfloop>
        </ul>
    <cfelse>
        <p>All directories already existed.</p>
    </cfif>
    
    <cflog file="backup_operations" type="information" text="Backup directory structure ready: #dayPath#">
    
    <cfcatch type="any">
        <p><strong>✗ Error:</strong> <cfoutput>#cfcatch.message#</cfoutput></p>
        <cflog file="backup_errors" type="error" text="Directory creation failed: #cfcatch.message#">
    </cfcatch>
</cftry>

<hr>

<h2>Example 3: Simulated Backup Process</h2>

<cftry>
    <cfset backupTimestamp = dateTimeFormat(now(), "yyyy-mm-dd_HH-nn-ss")>
    <cfset databases = ["CustomerDB", "OrdersDB", "InventoryDB"]>
    
    <p><strong>✓ Simulated Backup Process</strong></p>
    <p>Backup Timestamp: <cfoutput>#backupTimestamp#</cfoutput></p>
    
    <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse;">
        <tr style="background-color: ##f0f0f0;">
            <th>Database</th>
            <th>Backup Directory</th>
            <th>Status</th>
        </tr>
        <cfloop array="#databases#" index="dbName">
            <cfset backupPath = "backups\" & dateFormat(now(), "yyyy") & "\" & dateFormat(now(), "mm") & "\" & dateFormat(now(), "dd") & "\" & dbName>
            <cfoutput>
                <tr>
                    <td>#dbName#</td>
                    <td>#backupPath#</td>
                    <td style="color: green;">✓ Ready</td>
                </tr>
            </cfoutput>
        </cfloop>
    </table>
    
    <cfcatch type="any">
        <p><strong>✗ Error:</strong> <cfoutput>#cfcatch.message#</cfoutput></p>
    </cfcatch>
</cftry>

<hr>

<h2>Example 1: List All CFM Files (Simulating Image Filter)</h2>

<cftry>
    <cfset currentDir = getDirectoryFromPath(getCurrentTemplatePath())>
    
    <!--- List only CFM files as a demo (in production, use *.jpg|*.png|*.gif) --->
    <cfdirectory 
        action="list" 
        directory="#currentDir#" 
        name="mediaFiles" 
        filter="*.cfm"
        sort="name ASC">
    
    <p><strong>✓ Files Retrieved Successfully</strong></p>
    <p>Directory: <cfoutput>#currentDir#</cfoutput></p>
    <p>Total Files: <cfoutput>#mediaFiles.recordCount#</cfoutput></p>
    
    <cfif mediaFiles.recordCount GT 0>
        <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse;">
            <tr style="background-color: ##f0f0f0;">
                <th>File Name</th>
                <th>Size</th>
                <th>Upload Date</th>
                <th>Age</th>
            </tr>
            <cfloop query="mediaFiles">
                <cfset ageInDays = dateDiff("d", mediaFiles.dateLastModified, now())>
                <cfoutput>
                    <tr>
                        <td>#mediaFiles.name#</td>
                        <td>#numberFormat(mediaFiles.size/1024, "0.00")# KB</td>
                        <td>#dateFormat(mediaFiles.dateLastModified, "yyyy-mm-dd")#</td>
                        <td>#ageInDays# day(s)</td>
                    </tr>
                </cfoutput>
            </cfloop>
        </table>
    <cfelse>
        <p>No files found matching the filter.</p>
    </cfif>
    
    <cfcatch type="any">
        <p><strong>✗ Error:</strong> <cfoutput>#cfcatch.message#</cfoutput></p>
        <cflog file="gallery_errors" type="error" text="List error: #cfcatch.message#">
    </cfcatch>
</cftry>

<hr>

<h2>Example 2: Filter with Multiple Extensions</h2>

<cftry>
    <cfset currentDir = getDirectoryFromPath(getCurrentTemplatePath())>
    
    <!--- Demo: List CFM and CFC files (simulating JPG|PNG|GIF filter) --->
    <cfdirectory 
        action="list" 
        directory="#currentDir#" 
        name="allMediaFiles" 
        filter="*.cfm|*.cfc"
        sort="datelastmodified DESC">
    
    <p><strong>✓ Multiple File Types Retrieved</strong></p>
    <p>Filter Pattern: *.cfm|*.cfc (In production: *.jpg|*.png|*.gif)</p>
    <p>Found: <cfoutput>#allMediaFiles.recordCount#</cfoutput> file(s)</p>
    
    <cfif allMediaFiles.recordCount GT 0>
        <ul>
            <cfloop query="allMediaFiles">
                <cfset extension = listLast(allMediaFiles.name, ".")>
                <cfoutput>
                    <li>
                        <strong>#allMediaFiles.name#</strong> 
                        (#extension# | #numberFormat(allMediaFiles.size/1024, "0.00")# KB)
                    </li>
                </cfoutput>
            </cfloop>
        </ul>
    </cfif>
    
    <cfcatch type="any">
        <p><strong>✗ Error:</strong> <cfoutput>#cfcatch.message#</cfoutput></p>
    </cfcatch>
</cftry>

<hr>

<h2>Example 3: Simulated Product Image Gallery</h2>

<cftry>
    <!--- Create mock product image data --->
    <cfset mockImages = [
        {name: "product-laptop-2024.jpg", size: 256000, dateLastModified: now(), category: "Electronics"},
        {name: "product-phone-pro.jpg", size: 189000, dateLastModified: dateAdd("d", -2, now()), category: "Electronics"},
        {name: "product-headphones.png", size: 145000, dateLastModified: dateAdd("d", -5, now()), category: "Accessories"},
        {name: "banner-sale-2024.jpg", size: 512000, dateLastModified: dateAdd("d", -1, now()), category: "Marketing"},
        {name: "campaign-summer.gif", size: 89000, dateLastModified: dateAdd("d", -3, now()), category: "Marketing"}
    ]>
    
    <p><strong>✓ Product Image Gallery (Simulated Data)</strong></p>
    <p>Total Assets: <cfoutput>#arrayLen(mockImages)#</cfoutput></p>
    
    <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse; width: 100%;">
        <tr style="background-color: ##f0f0f0;">
            <th>File Name</th>
            <th>Format</th>
            <th>Size</th>
            <th>Upload Date</th>
            <th>Category</th>
        </tr>
        <cfloop array="#mockImages#" index="img">
            <cfset fileExt = uCase(listLast(img.name, "."))>
            <cfset sizeKB = numberFormat(img.size/1024, "0.00")>
            <cfoutput>
                <tr>
                    <td>#img.name#</td>
                    <td style="font-weight: bold; color: ##0066cc;">#fileExt#</td>
                    <td>#sizeKB# KB</td>
                    <td>#dateFormat(img.dateLastModified, "yyyy-mm-dd")#</td>
                    <td>#img.category#</td>
                </tr>
            </cfoutput>
        </cfloop>
    </table>
    
    <!--- Summary statistics --->
    <cfset totalSize = 0>
    <cfloop array="#mockImages#" index="img">
        <cfset totalSize = totalSize + img.size>
    </cfloop>
    
    <p><strong>Gallery Statistics:</strong></p>
    <ul>
        <cfoutput>
            <li>Total Files: #arrayLen(mockImages)#</li>
            <li>Total Size: #numberFormat(totalSize/1024/1024, "0.00")# MB</li>
            <li>Average File Size: #numberFormat((totalSize/arrayLen(mockImages))/1024, "0.00")# KB</li>
        </cfoutput>
    </ul>
    
    <cfcatch type="any">
        <p><strong>✗ Error:</strong> <cfoutput>#cfcatch.message#</cfoutput></p>
    </cfcatch>
</cftry>

<hr>