萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 遞歸刪除目錄及文件函數:支援類型過濾、安全檢查與擴展選項的完整實現

項目中常需「清理臨時目錄、按副檔名刪除快取、部署前清空構建產物」。本文提供生產級 delFile() 函數,支援遞歸刪除、文件類型過濾(陣列正則/字符串匹配)、目錄保留選項、完善錯誤處理,可直接納入工具庫。

函數簽名與參數

/**
 * 遞歸刪除目錄內文件/子目錄
 * @param string $dir        目標目錄絕對路徑
 * @param mixed  $fileType   可選:空=全部、字符串=包含該字符串、陣列[正則]=preg_match
 * @param bool   $deleteDir  是否刪除空目錄本身(預設 false 僅清空內容)
 * @return int               刪除文件數
 */

完整實現

安全增強建議(生產環境必加)

  1. 路徑白名單:限制 $dir 必須在允許根目錄(如 storage/app/temp)下,防止 delFile('/') 災難。
  2. 乾運行模式:新增 $dryRun 參數,僅輸出將刪除路徑不實際執行。
    if ($dryRun) { error_log("[DRY] Would delete: $path"); continue; }
  3. 權限檢查:is_writable($path) 先於 unlink()。
  4. 異常捕獲:包裝 try/catch 記錄失敗路徑,避免中斷批次處理。

效能優化提示

  • 大量文件(>10萬)考慮 RecursiveDirectoryIterator + FilterIterator 迭代器模式,避免 scandir() 全量載入內存。
  • SSD 上 unlink 很快,HDD 可考慮 exec('rm -rf ...') 批量刪除(需極謹慎驗證路徑)。

將此函數封裝為 FileSystem::cleanDirectory() 靜態方法,配合 Laravel Storage 外觀,即可獲得統一、可測試、可審計的文件清理能力。

copyright © 萬盛學電腦網 all rights reserved