PHP需用scandir()+unlink()+rmdir()组合递归删除目录,先遍历删子项再rmdir空目录,须校验is_dir、is_readable、is_writable,注意open_basedir限制、符号链接及Windows文件占用问题。

PHP 用 scandir() + unlink() + rmdir() 递归删目录
PHP 没有内置的「一键递归删除目录」函数,rm -rf 那种行为得自己组合实现。核心思路是:先遍历子项,对文件调用 unlink(),对子目录递归调用自身,最后用 rmdir() 删除空目录。
常见错误是直接 rmdir() 非空目录,会报错:Warning: rmdir(): Directory not empty。所以必须先清空内容。
- 务必检查目录是否存在且可读(
is_dir()+is_readable()),否则scandir()会警告 - 跳过
.和..目录项,否则递归会陷入死循环 - 删除前建议加
is_writable()判断,尤其在 Linux 下权限受限时 - Windows 下注意路径分隔符兼容性,
realpath()或str_replace()处理反斜杠更稳妥
完整可运行的递归删除函数
以下函数已处理常见边界情况,支持相对/绝对路径,返回布尔值表示是否成功:
function rrmdir($dir) {
if (!is_dir($dir)) {
return unlink($dir);
}
$items = scandir($dir);
foreach ($items as $item) {
if ($item === '.' || $item === '..') continue;
$path = $dir . DIRECTORY_SEPARATOR . $item;
rrmdir($path);
}
return rmdir($dir);
}
使用示例:rrmdir('/tmp/my_old_folder');。注意该函数不抛异常,失败时静默返回 false,生产环境建议加日志或 trigger_error()。
立即学习“PHP免费学习笔记(深入)”;
为什么不用 exec('rm -rf') 或 shell_exec()
虽然在 Linux 上一行命令能搞定,但隐患明显:
- 严重安全风险:若
$dir来自用户输入且未过滤,可能执行任意命令(如/path/to/dir; rm -rf /) - 跨平台失效:Windows 无
rm命令,del /s /q行为也不完全等价 - 权限依赖:Web 服务器用户(如 www-data)未必有 shell 执行权限,或被禁用
exec系列函数 - 错误难捕获:命令失败时仅返回空字符串或错误码,不如 PHP 原生函数便于判断具体哪步出错
删除前要特别注意的三个点
实际项目中,最容易栽跟头的地方不是逻辑,而是环境和意图误判:
-
open_basedir限制:如果 PHP 配置了open_basedir,而目标目录不在允许路径内,scandir()直接失败,连警告都不报——先用ini_get('open_basedir')检查 - 符号链接处理:默认
scandir()会把软链当普通目录读,导致误删目标位置。需用is_link()单独判断并跳过,或用lstat()区分 - 正在使用的文件:Windows 下若某文件被进程占用(如日志正被写入),
unlink()会失败,且后续rmdir()因目录非空也失败——建议加重试或提前clearstatcache()











