安全替换文件名需先用basename/dirname拆解glob返回的完整路径，避免覆盖、校验目标存在性，并用copy+unlink绕过Windows文件锁定。
glob 获取文件列表时怎么安全替换文件名
直接用 glob 列出文件再批量重命名，最常踩的坑是路径处理错误和同名覆盖。PHP 的 glob 返回的是完整匹配路径（含目录），不是纯文件名，必须先用 basename 和 dirname 拆解，否则 rename 会失败或误操作。
-
glob默认不递归，要匹配子目录得加GLOB_BRACE或手动遍历 - 通配符里不能写变量，比如
"*.{$ext}"要拼接字符串，别写成*.$ext（会被 shell 解析） - 目标文件名含特殊字符（空格、括号、中文）时，
rename在 Windows 下容易报错，建议用str_replace预清洗
PHP 批量替换文件名的核心代码结构
关键不是“怎么写循环”，而是“怎么避免覆盖+保留原路径+跳过正在重命名的文件”。下面这段是生产环境常用骨架：
$pattern = '/path/to/files/*.txt';
$files = glob($pattern);
foreach ($files as $old_path) {
$dir = dirname($old_path);
$name = basename($old_path);
$new_name = preg_replace('/^old_/', 'new_', $name); // 示例：前缀替换
$new_path = $dir . '/' . $new_name;
if ($old_path === $new_path) continue; // 跳过无需改名的
if (file_exists($new_path)) {
error_log("skip: {$new_path} already exists");
continue;
}
if (rename($old_path, $new_path)) {
echo "renamed: {$name} → {$new_name}\n";
}
}
用 preg_replace 替换文件名时要注意什么
preg_replace 是最灵活的方案，但正则写错会导致整个文件名被清空或截断。常见陷阱：
- 没加定界符，比如写成
preg_replace('^old_', 'new_', $name)—— 必须是/^old_/ - 没转义点号，想替换
.log却写成/\.log$/（漏了反斜杠）→ 实际应为/\.log$/ - 大小写不敏感需求没加
i修饰符，结果OLD_file.txt没被匹配 - 用
str_replace更简单时硬上正则，比如只是删后缀：pathinfo($name, PATHINFO_FILENAME)更稳
Windows 下 rename 失败的典型原因和绕过方式
在 Windows 上 rename 经常返回 false 却不报错，大概率是目标文件正被占用，或权限不足。临时文件锁、杀毒软件扫描、甚至资源管理器预览窗格都可能锁定文件。
立即学习“PHP免费学习笔记（深入）”；
- 先用
clearstatcache()清缓存，再用is_writable($old_path)检查可写性 - 若失败，尝试用
copy+unlink组合代替：copy($old_path, $new_path) && unlink($old_path) - 避免在系统临时目录（如
C:\Users\XXX\AppData\Local\Temp）批量操作，NTFS 权限更严 - 脚本运行前关闭资源管理器中对应文件夹窗口，尤其有缩略图预览时
真正麻烦的不是语法，是文件系统状态不可见——重命名失败往往不抛异常，只静默跳过。加日志和 file_exists 校验比优化正则重要得多。
