PHP递归删除目录及文件代码示例

本文详细讲解了PHP中如何安全、可靠地递归删除目录及文件，强调PHP缺乏内置“一键清空”功能，必须通过scandir()、unlink()和rmdir()组合实现，并深入剖析了常见陷阱——如未校验目录可读写性导致的静默失败、Windows文件占用、open_basedir限制、符号链接误删、路径分隔符兼容性等关键问题；同时提供了一个健壮、跨平台、已处理边界情况的rrmdir()函数，并明确指出避免使用exec('rm -rf')等shell命令的原因：安全隐患大、跨平台差、权限受限且错误难追踪，帮助开发者写出更稳定、更安全的生产级删除逻辑。

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()。

为什么不用 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()

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP递归删除目录及文件代码示例》文章吧，也可关注golang学习网公众号了解相关技术文章。