核心函式
<?php
/**
* 遞迴刪除目錄及其內容
* @param string $dir 目錄路徑
* @param bool $self 是否刪除目錄本身 (true=整個目錄刪除, false=僅清空內容)
* @return bool 成功與否
*/
function rrmdir(string $dir, bool $self = true): bool
{
$dir = rtrim($dir, '/\\');
if (!is_dir($dir)) return false;
$items = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS),
RecursiveIteratorIterator::CHILD_FIRST // 先刪子項,再刪父目錄
);
foreach ($items as $item) {
$path = $item->getPathname();
if ($item->isLink() || $item->isFile()) {
@unlink($path); // 忽略權限錯誤,盡力刪除
} elseif ($item->isDir()) {
@rmdir($path);
}
}
return $self ? @rmdir($dir) : true;
}
// 使用
rrmdir('/tmp/cache'); // 刪除整個目錄
rrmdir('/var/www/uploads', false); // 僅清空內容,保留目錄
關鍵設計點
- CHILD_FIRST:深度優先、子目錄先於父目錄刪除,避免「目錄非空」錯誤
- SKIP_DOTS:自動跳過
. ..
- isLink() 優先 unlink():避免追蹤符號連結刪除到目標真實檔案
- @ 抑制警告:權限不足時繼續處理其他檔案,最終回傳整體結果
進階:權限修正後再刪(處理 root 建立的檔案)
function rrmdirForce(string $dir, bool $self = true): bool
{
$dir = rtrim($dir, '/\\');
if (!is_dir($dir)) return false;
// 嘗試修正權限(需執行者有 sudo 或為檔案擁有者)
$iterator = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS),
RecursiveIteratorIterator::CHILD_FIRST
);
foreach ($iterator as $item) {
@chmod($item->getPathname(), 0777);
}
@chmod($dir, 0777);
return rrmdir($dir, $self);
}
Symfony Filesystem / Laravel File 封裝
// Symfony
use Symfony\Component\Filesystem\Filesystem;
$fs = new Filesystem();
$fs->remove('/tmp/cache'); // 內建遞迴、例外處理
// Laravel
use Illuminate\Support\Facades\File;
File::deleteDirectory('/tmp/cache');
效能提示
- 超大目錄(>10萬檔)建議分批、非同步處理,避免 PHP 超時
- SSD 上
unlink 极快,HDD 可考慮 exec('rm -rf ' . escapeshellarg($dir))(需極謹慎)