PHP递归实现目录操作：遍历、复制、删除与大小计算

Owen

发布时间：2026-10-15| 3人浏览过

原创

在PHP开发中，经常需要处理复杂的文件系统任务，如批量迁移备份、清理临时文件或统计资源占用。由于文件系统呈现树状结构，递归是解决此类问题的核心逻辑。本文将通过四个独立且完整的代码示例，演示如何遍历、复制、删除目录以及计算其总大小，帮助开发者掌握opendir、readdir、is_dir等关键函数的组合应用。

准备条件与环境说明

所有示例均基于标准PHP环境运行，无需额外扩展。执行涉及删除或覆盖的操作前，务必确认目标路径无重要数据，因为递归删除通常是不可逆的。代码中的路径为相对路径（如./final/factapplication），实际使用时请根据服务器文件结构调整。

第1步：递归遍历并列出目录内容

目的：深入指定目录及其子目录，输出所有非隐藏文件的名称。

原理：通过opendir打开句柄，readdir循环读取文件名，利用is_dir判断类型。若为目录则调用自身继续深入，若为文件则直接打印。

<?php
header("content-type:text/html;charset=utf-8");
$dirname = "./final/factapplication";

function listdir($dirname) {
    $ds = opendir($dirname);
    while (false !== ($file = readdir($ds))) {
        $path = $dirname.'/'.$file;
        if ($file != '.' && $file != '..') {
            if (is_dir($path)) {
                listdir($path); // 递归进入子目录
            } else {
                echo $file."<br>"; // 输出文件名
            }
        }
    }
    closedir($ds);
}
listdir($dirname);
?>

完成状态：控制台输出目标目录下的所有文件名，包含深层嵌套结构中的文件。

第2步：递归复制整个目录结构

目的：将源目录$srcdir下的所有文件和子目录完整克隆至$dstdir。

要点：使用mkdir创建目标根目录，在遇到子目录时先创建对应的目标子目录，再递归处理；遇到文件时使用copy()进行物理拷贝。

<?php
$srcdir = "../fileupload";
$dstdir = "b";

function copydir($srcdir, $dstdir) {
    mkdir($dstdir);
    $ds = opendir($srcdir);
    while (false !== ($file = readdir($ds))) {
        $path = $srcdir."/".$file;
        $dstpath = $dstdir."/".$file;
        if ($file != "." && $file != "..") {
            if (is_dir($path)) {
                copydir($path, $dstpath); // 递归复制子目录
            } else {
                copy($path, $dstpath); // 复制单个文件
            }
        }
    }
    closedir($ds);
}
copydir($srcdir, $dstdir);
?>

风险提示：copy()若目标路径已存在同名文件可能被覆盖，执行前建议检查目标位置状态。

第3步：递归删除目录及其所有内容

目的：清空指定目录，包括其中的所有文件和子文件夹，最后移除目录本身。

逻辑：遵循“自底向上”原则，即先删除子目录内的文件，再删除子目录，最后删除当前层级的文件，直至返回rmdir删除空目录。

<?php
$dirname = 'a';

function deldir($dirname) {
    $ds = opendir($dirname);
    while (false !== ($file = readdir($ds))) {
        $path = $dirname.'/'.$file;
        if($file != '.' && $file != '..') {
            if (is_dir($path)) {
                deldir($path); // 递归删除子目录
            } else {
                unlink($path); // 删除具体文件，注意需带完整路径
            }
        }
    }
    closedir($ds);
    return rmdir($dirname); // 删除当前空目录
}
deldir($dirname);
?>

关键细节：unlink($path)必须传入完整的文件路径参数，仅传文件名可能导致在当前脚本目录下误删文件。此操作具有高风险，生产环境中慎用。

第4步：递归计算文件夹总大小

目的：统计指定目录及其子目录下所有文件的字节总和。

难点：递归函数通常逐层返回，若直接在每次调用中返回累计值容易导致重复计算或层级丢失。此处使用static修饰变量$tot，使其在所有递归层级中共享内存空间，累加后统一返回。

<?php
$dirname = "a";

function dirsize($dirname) {
    static $tot; // 静态变量保持跨层级累加
    $ds = opendir($dirname);
    while (false !== ($file = readdir($ds))) {
        $path = $dirname.'/'.$file;
        if ($file != '.' && $file != '..') {
            if(is_dir($path)) {
                dirsize($path); // 递归进入子目录累加
            } else {
                $tot = $tot + filesize($path); // 累加文件大小
            }
        }
    }
    closedir($ds);
    return $tot;
}
echo dirsize($dirname);
?>