PHP 遞歸刪除目錄三大實現：遞歸、系統調用、迭代器模式深度解析

PHP 遞歸刪除目錄三大實現：遞歸、系統調用、迭代器模式深度解析

刪除非空目錄是 PHP 文件系統操作的常見需求。rmdir() 僅能刪除空目錄，因此需遞歸清理子目錄與檔案。本文深度解析三種主流實現方式：純 PHP 遞歸、系統命令調用、目錄迭代器模式，對比效能、可移植性與安全性，助你選擇最適合場景的方案。

方法一：純 PHP 遞歸函數（跨平台、可控性最強）

<?php
function deleteDir($dir) {
    // 嘗試直接刪除（空目錄情況）
    if (rmdir($dir) === false && is_dir($dir)) {
        // 打開目錄讀取內容
        if ($dp = opendir($dir)) {
            while (($file = readdir($dp)) !== false) {
                $fullPath = $dir . DIRECTORY_SEPARATOR . $file;
                
                // 跳過 . 和 ..
                if ($file === '.' || $file === '..') continue;
                
                if (is_dir($fullPath)) {
                    // 子目錄遞歸刪除
                    deleteDir($fullPath);
                } else {
                    // 檔案直接刪除
                    unlink($fullPath);
                }
            }
            closedir($dp);
        } else {
            // 權限不足或非目錄
            exit('Not permission or invalid directory: ' . $dir);
        }
        
        // 子內容清空後，再次嘗試刪除目錄本身
        @rmdir($dir);
    }
}

優化要點（原碼缺失）：

• 使用 DIRECTORY_SEPARATOR 確保跨平台路徑正確
• 構建完整路徑 $fullPath 而非直接用 $file（原碼 Bug：is_dir($file) 判斷相對路徑會失效）
• 最後執行 @rmdir($dir) 清理空目錄

特性評估

方法二：系統命令調用（效能最強、平台相關）

<?php
function del_dir($dir) {
    // 防止命令注入：必須對 $dir 嚴格驗證、轉義
    $dir = escapeshellarg($dir);
    
    if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
        // Windows: rmdir /s /q 強制安靜刪除目錄樹
        $cmd = "rmdir /s /q $dir";
    } else {
        // Linux/Unix: rm -rf 遞歸強制刪除
        $cmd = "rm -rf $dir";
    }
    
    // 執行命令
    exec($cmd, $output, $return_var);
    
    if ($return_var !== 0) {
        throw new RuntimeException("Directory deletion failed: $cmd");
    }
    
    return true;
}

關鍵安全警示：

• 必須使用 escapeshellarg() 對路徑轉義，防止路徑包含空格、分號、反引號等導致命令注入
• 禁用函數檢查：許多虛擬主機禁用 exec()、system()、shell_exec()，需確認環境支援
• 權限要求：PHP 進程用戶需擁有目標目錄的寫入/執行權限

特性評估

方法三：DirectoryIterator 迭代器模式（現代 PHP 推薦、物件導向）

<?php
function deltree($pathdir) {
    // 規範化路徑
    $pathdir = rtrim($pathdir, DIRECTORY_SEPARATOR);
    
    if (!is_dir($pathdir)) {
        throw new InvalidArgumentException("Not a directory: $pathdir");
    }
    
    // 使用 DirectoryIterator 遍歷（自動跳過 . 和 ..）
    $items = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($pathdir, 
            RecursiveDirectoryIterator::SKIP_DOTS),
        RecursiveIteratorIterator::CHILD_FIRST  // 關鍵：子優先（後序遍歷）
    );
    
    foreach ($items as $item) {
        if ($item->isFile() || $item->isLink()) {
            unlink($item->getPathname());
        } elseif ($item->isDir()) {
            rmdir($item->getPathname());
        }
    }
    
    // 最後刪除根目錄
    rmdir($pathdir);
    
    return true;
}

核心優勢：

• CHILD_FIRST 模式：自動實現後序遍歷（先刪子文件/子目錄，再刪父目錄），無需手寫遞歸
• SKIP_DOTS 旗標：自動過濾 . 和 ..，避免無限遞歸
• 物件導向：代碼清晰、可擴展（如加入大小統計、修改時間過濾）
• 記憶體友善：迭代器逐個處理，不載入全量路徑列表

特性評估

輔助函數：判斷目錄是否為空

<?php
function is_empty_dir($pathdir) {
    $handle = @opendir($pathdir);
    if (!$handle) return false; // 不存在或權限不足視為非空
    
    $count = 0;
    while (($entry = readdir($handle)) !== false) {
        if ($entry !== '.' && $entry !== '..') {
            $count++;
            if ($count > 0) break; // 發現非 . / .. 即非空
        }
    }
    closedir($handle);
    return $count === 0;
}

綜合對比與選型建議

最佳實踐检查清單

1. 路徑規範化：使用 realpath() 解析符號鏈接，rtrim($path, DIRECTORY_SEPARATOR) 去除尾部分隔符
2. 存在性檢查：操作前確認 is_dir()，避免誤刪
3. 權限驗證：確保 PHP 進程用戶有 unlink/rmdir 權限
4. 異常處理：包裝 try-catch，記錄失敗詳情，避免靜默失敗
5. 防止誤刪：關鍵目錄加保護標記（如 .keep 檔案），刪除前檢查
6. 測試驗證：先在測試環境用 tree 或 find 驗證刪除結果

總結

PHP 刪除非空目錄的三大範式：

• 遞歸函數：經典、可控、跨平台，適合邏輯複雜場景
• 系統命令：暴力、高效、危險，適合大規模清理 CLI 任務
• SPL 迭代器：現代、優雅、高效，新專案首選

理解各方案權衡，結合業務場景與環境約束選擇，才能寫出安全、高效、可維護的文件系統操作代碼。