PHP删除文件夹及内容的正确方法

PHP删除非空文件夹并非调用一个函数就能搞定，而是必须严谨执行“递归清空→校验权限→安全移除”的三步流程：先用scandir()或更健壮的SPL迭代器遍历并逐层删除子文件与子目录（自动跳过.和..），再确认路径合法性（防止../路径穿越和绝对路径越界）、检查写权限、规避shell命令注入风险，最后才调用rmdir()删除空目录；任何环节疏忽——如忽略系统差异、未处理只读文件或绕过PHP直接执行rm -rf——都可能引发静默失败、误删关键数据甚至安全漏洞，因此看似简单的删除操作实则考验开发者对文件系统、权限模型与防御式编程的深度理解。

PHP删除文件夹前必须清空内容

PHP没有直接删除非空文件夹的函数，rmdir() 只能删空目录，否则会报错 Warning: rmdir(): Directory not empty。所以安全删除的本质是「先递归清理，再删目录本身」。

常见错误是直接调用 rmdir($path) 而不检查是否为空，或用 exec('rm -rf') 忽略权限和跨平台问题。

• Windows 下 exec('rm -rf') 无效，且 shell 命令存在注入风险（尤其路径来自用户输入）
• scandir() 返回的 . 和 .. 必须跳过，否则可能引发无限递归或权限错误
• 删除失败时，unlink() 和 rmdir() 都返回 false，但不会抛出异常，需手动判断并处理

用递归函数安全删除整个目录树

最可控的方式是手写递归遍历：先删子项（文件或子目录），再删当前目录。以下是一个精简可靠的实现：

function deleteDir($path) {
    if (!is_dir($path)) return true;
    $items = array_diff(scandir($path), ['.', '..']);
    foreach ($items as $item) {
        $fullPath = $path . DIRECTORY_SEPARATOR . $item;
        if (is_dir($fullPath)) {
            deleteDir($fullPath); // 递归删子目录
        } else {
            unlink($fullPath); // 删文件
        }
    }
    return rmdir($path); // 最后删空目录
}

注意：DIRECTORY_SEPARATOR 保证 Windows/Linux 路径兼容；array_diff() 过滤掉 . 和 .. 更稳妥，比字符串判断更安全。

用 SPL 迭代器替代 scandir() 更健壮

scandir() 在大目录下可能内存占用高，且无法跳过符号链接或隐藏文件（如 .git）。用 RecursiveDirectoryIterator 可以更精细控制：

$iter = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator($path, FilesystemIterator::SKIP_DOTS),
    RecursiveIteratorIterator::CHILD_FIRST
);

foreach ($iter as $file) {
    if ($file->isDir()) {
        rmdir($file->getPathname());
    } else {
        unlink($file->getPathname());
    }
}
rmdir($path);

关键点：FilesystemIterator::SKIP_DOTS 自动跳过 . 和 ..；CHILD_FIRST 确保子项先于父目录被处理，避免删到一半就卡住。

删除前务必校验路径合法性与权限

用户传入的路径若含 ../ 或绝对路径（如 /var/www），可能误删系统关键目录。安全做法是：

• 用 realpath($path) 获取真实路径，再用 strpos() 检查是否在允许根目录内，例如：strpos(realpath($path), '/var/www/html') === 0
• 用 is_writable() 确认有写权限，避免删到一半因权限中断
• 生产环境禁用 exec()、system() 等函数，防止绕过 PHP 层逻辑

递归删除看似简单，但路径解析、权限判断、错误恢复这三步漏掉任何一环，都可能导致静默失败或误删——尤其是当目录里混着只读文件、挂载点或进程锁定的文件时。

今天关于《PHP删除文件夹及内容的正确方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！