PHP怎么删除非空目录_rmdir递归删除实现方法【方法】

苏承栈

2026-09-23 • 👁 0人浏览过

rmdir只能删除空目录，因封装POSIX系统调用且无递归功能；删非空目录需用RecursiveDirectoryIterator配合CHILD_FIRST遍历后逐层删除，或严格过滤后调用系统命令。 PHP

rmdir

为什么直接删非空目录会报错

rmdir

函数设计上只接受**空目录**，只要目录里有哪怕一个文件、子目录、隐藏文件（比如

.git

或

.DS_Store

），调用就会失败，并抛出

Warning: rmdir(): Directory not empty

。这不是 bug，是 POSIX 级别的行为约束——PHP 的

rmdir

直接封装了系统调用，不处理递归逻辑。常见错误现象：

rmdir('/path/to/dir')

false

，但没报错（因错误报告级别设置），结果目录还在；或者开了

E_WARNING

就看到满屏警告。别指望

rmdir

自带递归开关——它根本没有

$recursive

参数别先

scandir

再挨个

unlink

却忘了删子目录本身，最后

rmdir

还是失败 Windows 下注意路径分隔符，但

rmdir

和

unlink

都支持正斜杠，不用硬切

\

手动递归删除：用

RecursiveDirectoryIterator

最稳这是 PHP 5.3+ 原生推荐方式，能自动跳过

.

和

..

，天然支持符号链接判断，且可捕获异常（比如权限不足）。比手写

scandir + foreach

更少漏掉隐藏文件或循环引用。实操建议：立即学习 “ PHP免费学习笔记（深入） ”；用

RecursiveIteratorIterator

包一层，把嵌套结构“拉平”，避免自己写递归函数必须从最深层开始删（

RecursiveIteratorIterator::CHILD_FIRST

），否则父目录删不掉对每个

SplFileInfo

对象，先用

isDir()

判断，再决定调用

unlink()

还是

rmdir()

简短示例： PHP 8.5.5 PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。下载

function rrmdir($dir) {
    $iter = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS),
        RecursiveIteratorIterator::CHILD_FIRST
    );
    foreach ($iter as $file) {
        if ($file->isDir()) {
            rmdir($file->getPathname());
        } else {
            unlink($file->getPathname());
        }
    }
    return rmdir($dir);
}

用

exec

调系统命令的坑要当心 Linux/macOS 下有人图快写

exec("rm -rf $dir")

，看似一行解决，但风险集中：

$dir

如果含空格、换行或

*

，没过滤就拼进 shell，可能误删其他路径（命令注入） Windows 不认

rm -rf

，得切

rd /s /q

，跨平台维护成本陡增 Web 服务器（如 Apache/Nginx）通常禁用

exec

类函数，线上环境大概率失败即使成功，也绕过了 PHP 的 open_basedir 限制和用户权限检查，安全策略形同虚设除非你完全控制运行环境、输入绝对可信、且明确需要删巨量小文件（此时系统命令确实更快），否则别碰。删之前必须检查的三件事递归删除不可逆，一旦执行就无法撤回。容易被忽略但实际高频出问题的点：确认

$dir

是绝对路径，相对路径在 CLI 和 Web 下行为不一致（比如

__DIR__ . '/cache'

比

'./cache'

安全得多）检查目标是否为软链接——

is_link($dir)

为

true

时，

rmdir

会删链接本身，不是链接指向的目录留意 SELinux 或容器环境下的权限模型：即使 PHP 进程有写权限，也可能被策略拦截，此时

rmdir

静默失败，需查

getlasterror()

或系统日志删生产目录前，至少

echo

一遍路径，肉眼核对；批量操作加

if (false) { ... }

开关保命。

相关文章