項目中常需「清理臨時目錄、按副檔名刪除快取、部署前清空構建產物」。本文提供生產級 delFile() 函數,支援遞歸刪除、文件類型過濾(陣列正則/字符串匹配)、目錄保留選項、完善錯誤處理,可直接納入工具庫。
/**
* 遞歸刪除目錄內文件/子目錄
* @param string $dir 目標目錄絕對路徑
* @param mixed $fileType 可選:空=全部、字符串=包含該字符串、陣列[正則]=preg_match
* @param bool $deleteDir 是否刪除空目錄本身(預設 false 僅清空內容)
* @return int 刪除文件數
*/
$dir 必須在允許根目錄(如 storage/app/temp)下,防止 delFile('/') 災難。$dryRun 參數,僅輸出將刪除路徑不實際執行。if ($dryRun) { error_log("[DRY] Would delete: $path"); continue; }is_writable($path) 先於 unlink()。try/catch 記錄失敗路徑,避免中斷批次處理。RecursiveDirectoryIterator + FilterIterator 迭代器模式,避免 scandir() 全量載入內存。unlink 很快,HDD 可考慮 exec('rm -rf ...') 批量刪除(需極謹慎驗證路徑)。將此函數封裝為 FileSystem::cleanDirectory() 靜態方法,配合 Laravel Storage 外觀,即可獲得統一、可測試、可審計的文件清理能力。