PHP无自动重命名函数，需用scandir()或glob()配合rename()及字符串处理；关键在安全改名，须处理路径拼接、编码、权限、文件占用、跨文件系统等风险。

PHP 用 foreach 遍历目录并批量重命名文件

直接上结论：PHP 本身不提供“自动替换文件名”的函数，必须手动组合 scandir()（或 glob()）、rename() 和字符串处理逻辑。关键不是“能不能遍历”，而是“怎么安全地改名”——稍有不慎就会覆盖、丢失或权限失败。

为什么不能直接 foreach + rename() 就完事？

常见错误是忽略路径拼接、相对/绝对路径混淆、中文编码、文件正在被占用等现实约束。比如：

• rename('old.jpg', 'new.jpg') 默认在当前工作目录操作，不是你 scandir() 的那个目录
• Windows 下对大小写不敏感，但 Linux 会把 FILE.JPG 当成和 file.jpg 不同的文件，重命名可能静默失败
• 如果新文件名已存在，rename() 返回 false，但不会报错，容易漏判
• 中文文件名在 UTF-8 脚本里可能因系统 locale 导致乱码，尤其在旧版 PHP 或 CLI 环境下

安全替换文件名的最小可靠写法

以下示例以「把当前目录下所有 .log 文件名中的 error 替换为 warn」为例，保留原路径、检查权限、跳过目录：

if (!is_dir($dir = '.')) {
    die("目录不存在");
}

$files = scandir($dir);
foreach ($files as $filename) {
    $path = $dir . '/' . $filename;
    if (!is_file($path) || pathinfo($filename, PATHINFO_EXTENSION) !== 'log') {
        continue;
    }

    $newName = str_replace('error', 'warn', $filename);
    $newPath = $dir . '/' . $newName;

    if ($filename === $newName) continue; // 无需改名
    if (file_exists($newPath)) {
        echo "跳过：{$newName} 已存在\n";
        continue;
    }

    if (rename($path, $newPath)) {
        echo "已重命名：{$filename} → {$newName}\n";
    } else {
        echo "失败：无法重命名 {$filename}\n";
    }
}

更实用的替换场景：按规则生成新名（如时间戳、序号）

真实需求往往不是简单字符串替换，而是加前缀、补零序号、转小写等。注意这些细节：

• 用 basename() 和 dirname() 拆解路径，避免硬拼 /
• 批量重命名时建议先 echo 出计划操作，确认无误再取消注释 rename()
• 如果要递归处理子目录，别用 scand

  

  ir 嵌套，改用 RecursiveDirectoryIterator
• rename() 在跨文件系统（如从 /tmp 到 /home）时会失败，此时需 copy() + unlink()