
PHP递归删除非空文件夹的正确姿势
直接上结论:PHP没有内置函数能一键删掉非空目录,rmdir()只接受空文件夹,强行用会报 Directory not empty 错误。必须自己遍历+逐个删文件和子目录,再删父目录。
为什么不能只用 rmdir() 或 unlink()
rmdir() 要求目录必须为空,否则失败;unlink() 只能删文件,对目录直接报 Is a directory 错误。两者都不处理嵌套结构,也没有“强制递归”开关。
- 常见错误现象:
rmdir('path/to/dir')返回false,error_get_last()显示Directory not empty - 误用
unlink()删目录时,PHP 8.0+ 会抛出Warning: unlink(): Is a directory - Windows 下路径分隔符混用(
\vs/)可能让scandir()返回 false,导致循环跳过子项
手写递归删除函数要注意的三件事
核心逻辑是:先删里面(文件+子目录),再删自己。但顺序、权限、符号链接这三点最容易翻车。
- 必须后序遍历:先
scandir()拿到所有子项 → 递归删每个子目录/文件 → 最后rmdir()当前目录。前序删会导致子项读取失败 - 跳过
.和..:不检查会触发无限递归或权限错误;建议用array_diff(scandir($dir), ['.', '..']) - 符号链接要单独处理:
is_link($item)为 true 时,用unlink()而不是rmdir(),否则报错 - 权限问题:如果某文件被设为只读(尤其 Windows),
unlink()会失败,得先chmod($file, 0777)再删
示例关键片段:
立即学习“PHP免费学习笔记(深入)”;
function rrmdir($dir) {
if (!is_dir($dir)) return;
$items = array_diff(scandir($dir), ['.', '..']);
foreach ($items as $item) {
$path = $dir . DIRECTORY_SEPARATOR . $item;
if (is_link($path)) {
unlink($path);
} elseif (is_dir($path)) {
rrmdir($path);
} else {
chmod($path, 0777); // 防只读
unlink($path);
}
}
return rmdir($dir);
}
更稳的方案:用 RecursiveDirectoryIterator + RecursiveIteratorIterator
比手写递归更可靠,底层自动处理符号链接、权限、跨平台路径,且支持过滤(比如跳过特定文件名)。但注意 PHP 版本和异常捕获。
- PHP 5.3+ 可用,但
RecursiveIteratorIterator::CHILD_FIRST模式必须显式指定,否则默认是前序遍历,删不掉目录 - 没加
try/catch时,遇到权限不足的文件会直接 fatal error;建议用set_error_handler()或检查is_writable()前置判断 - 不要用
glob()替代:它不递归,也不识别符号链接类型,容易漏删
简短可用示例:
$it = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS),
RecursiveIteratorIterator::CHILD_FIRST
);
foreach ($it as $file) {
$file->isLink() ? unlink($file) : ($file->isDir() ? rmdir($file) : (chmod($file, 0777) && unlink($file)));
}
rmdir($dir);
真正麻烦的不是写几行代码,而是目录里混着只读文件、挂载点、符号链接、正在被其他进程占用的句柄——这些情况不会报明显错误,但删到一半就停住,还留着空壳目录。











