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";
}
}
更实用的替换场景：按规则生成新名（如时间戳、序号）
真实需求往往不是简单字符串替换，而是加前缀、补零序号、转小写等。注意这些细节：
立即学习“PHP免费学习笔记（深入）”；
- 用
basename()和dirname()拆解路径，避免硬拼/ - 批量重命名时建议先
echo出计划操作，确认无误再取消注释rename() - 如果要递归处理子目录，别用
scandir嵌套，改用RecursiveDirectoryIterator -
rename()在跨文件系统（如从/tmp到/home）时会失败，此时需copy()+unlink()
ls -l 或右键属性看权限。 
