PHP 遞迴刪除目錄與檔案的兩種實作方式

前言

在 PHP 開發中，常需刪除整個目錄樹（包含子目錄與檔案）。本文提供兩個實用函式：clean_dir() 與 DeltreeDir()，分別展示不同的遞迴邏輯，供開發者參考使用。

方法一：clean_dir() - 簡潔遞迴刪除

此函式先判斷路徑是否為目錄，若為檔案則直接刪除；若為目錄則遞迴處理內容，最後移除空目錄。

<?php
/**
 * 遞迴清空並刪除指定目錄
 * @param string $path 目錄或檔案路徑
 */
function clean_dir($path) {
    // 若非目錄，檢查是否為檔案並刪除
    if (!is_dir($path)) {
        if (is_file($path)) {
            unlink($path);
        }
        return;
    }

    // 開啟目錄讀取內容
    $handle = opendir($path);
    while (($file = readdir($handle)) !== false) {
        // 跳過當前目錄與上層目錄
        if ($file === '.' || $file === '..') continue;
        // 遞迴處理子項目
        clean_dir($path . DIRECTORY_SEPARATOR . $file);
    }
    closedir($handle);

    // 刪除空目錄
    rmdir($path);
}
?>

方法二：DeltreeDir() - 更健壯的刪除邏輯

此版本加入路徑正規化、符號連結檢查、錯誤抑制與路徑分隔符自動補齊，適合生產環境使用。

<?php
/**
 * 刪除指定目錄下所有檔案與子目錄（類似 DOS deltree）
 * @param string $dir 目錄路徑
 * @return int 成功返回 1，失敗返回 0
 */
function DeltreeDir($dir) {
    // 取得真實路徑並驗證
    $dir = realpath($dir);
    if (!$dir || !@is_dir($dir)) return 0;

    // 確保路徑以分隔符結尾
    if ($dir[strlen($dir) - 1] !== DIRECTORY_SEPARATOR) {
        $dir .= DIRECTORY_SEPARATOR;
    }

    $handle = @opendir($dir);
    if (!$handle) return 0;

    while (($file = @readdir($handle)) !== false) {
        if ($file === '.' || $file === '..') continue;

        $fullPath = $dir . $file;

        // 遇到子目錄且非符號連結則遞迴刪除
        if (@is_dir($fullPath) && !is_link($fullPath)) {
            DeltreeDir($fullPath);
        } else {
            // 刪除檔案
            @unlink($fullPath);
        }
    }
    closedir($handle);

    // 刪除空目錄
    @rmdir($dir);
    return 1;
}
?>

使用範例

<?php
// 刪除測試目錄
$target = __DIR__ . '/temp_uploads';
if (DeltreeDir($target)) {
    echo "目錄 {$target} 及其內容已成功刪除。";
} else {
    echo "刪除失敗，請檢查權限或路徑是否存在。";
}
?>

注意事項

• 執行刪除操作前請務必確認路徑正確，避免誤刪重要資料。
• PHP 執行身分需具備目標目錄的寫入與刪除權限。
• 大量檔案刪除可能超過 max_execution_time，必要時調整 set_time_limit()。
• 生產環境建議加入日誌記錄與例外處理機制。

這兩個函式各有優劣：clean_dir() 程式碼簡潔適合教學；DeltreeDir() 考量更多邊界情況，適合實際專案部署。根據需求選擇即可。