PHP递归批量修改目录及子目录下文件后缀的方法

核心实现思路

实现该功能的关键在于两个步骤：一是能够深入获取嵌套结构的所有文件路径；二是对文件名进行严谨的解析以确保只修改目标文件。简单的字符串替换容易因文件名中包含相似字符而导致误改，因此推荐使用 pathinfo() 函数提取文件的真实扩展名信息。

准备条件

1. 运行环境：本地需拥有已安装 PHP 的环境（如 XAMPP, WAMP 或宝塔面板）。
2. 权限要求：执行脚本的进程需要对目标文件夹具有“读取”和“写入/重命名”权限。
3. 数据安全提醒：在执行批量修改前，务必对原文件夹进行完整备份！批量操作不可逆，一旦误删或错改名，可能丢失原始数据。

第1步：编写递归遍历文件的函数

由于需要处理的可能是多层级嵌套的文件夹结构，必须使用递归算法来收集所有符合条件的文件绝对路径。

• 目的：扫描主目录，自动进入子目录，最终返回所有文件的完整路径数组。
• 动作：使用 opendir() 和 readdir() 配合递归调用自身。

// 递归获取目录下所有文件的函数
function get_all_files($dir) {
    $files = array();
    
    // 如果传入的是单个文件而非目录，直接返回
    if (is_file($dir)) {
        return $dir;
    }
    
    $handle = opendir($dir);
    if ($handle) {
        while (false !== ($file = readdir($handle))) {
            // 跳过当前目录(.)和父目录(..)
            if ($file != '.' && $file != '..') {
                $filename = $dir . "/" . $file;
                if (is_file($filename)) {
                    $files[] = $filename;
                } else {
                    // 如果是子目录，递归调用
                    $subFiles = get_all_files($filename);
                    $files = array_merge($files, $subFiles);
                }
            }
        }
        closedir($handle);
    }
    return $files;
}

第2步：配置常量并定义目标范围

在脚本头部定义源后缀和目标后缀，以及要扫描的主目录。确保代码文件放置在与待处理文件或上级目录同级的位置，或者直接指定绝对路径。

第3步：执行安全的文件重命名逻辑

这是最核心的部分。为避免使用 str_replace() 导致文件名中偶然出现的“.gif”字符串被错误截断（例如文件名为 “my_gif_image.png” 会被错误处理），必须使用 pathinfo() 严格匹配扩展名。

• 入口：上一步获取的文件路径数组 $arr。
• 动作：逐一遍历文件，解析其扩展名，判断是否等于 OLD_EXT。若相等，则生成新文件名并使用 rename() 进行物理重命名。
• 完成状态判断：若 rename() 返回 true 表示成功，否则记录错误或保持原状。

foreach ($arr as $filePath) {
    // 解析文件信息
    $pathParts = pathinfo($filePath);
    
    // 严格判断扩展名是否匹配
    if ($pathParts["extension"] == OLD_EXT) {
        // 拼接新路径：保留 dirname + 去掉旧后缀的新basename + 新后缀
        $newName = $pathParts["dirname"] . "/" . $pathParts["filename"] . NEW_EXT;
        
        // 执行重命名
        if (@rename($filePath, $newName)) {
            echo "成功重命名: {$filePath} -> {$newName}\n";
        } else {
            echo "失败: 无法重命名 {$filePath}\n";
        }
    }
}
?>

注意事项与排错建议

1. 跨分区移动限制：PHP 的 rename() 函数不能将文件移动到不同的磁盘分区（例如从 C 盘移到 D 盘）。如果在 Linux 系统下操作，需确保文件仍在同一挂载点内。
2. 权限不足：如果遇到“Permission denied”错误，请检查服务器目录权限设置（通常 Web 运行用户需具备写权限）。
3. 日志排查：建议在正式大批量运行前，先用少量测试文件验证逻辑是否正确，观察控制台输出的成功/失败信息。

总结

以上便是利用 PHP 递归遍历目录并批量更改文件后缀扩展名的详细内容。通过正确使用 pathinfo 函数，可以有效防止文件名误替换带来的数据灾难。更多关于文件操作与自动化管理的资料请关注本站其它相关文章！