PHP批量重命名前需先模拟预览:用glob()和pathinfo()提取文件信息,仅替换basename部分并保留原扩展名,输出“原路径 → 新路径”对比结果,同时检查重名、权限及跨分区问题。

PHP 文件名批量替换前怎么预览效果
直接改文件名有风险,尤其批量操作时容易误删或覆盖。PHP 本身没有内置“dry-run”模式,必须手动模拟——核心思路是:先生成新文件名,不执行 rename(),而是打印出“原路径 → 新路径”的映射关系。
用 glob() + pathinfo() 提取并构造新文件名
别硬写正则去拆路径,pathinfo() 能安全分离目录、文件名、扩展名;替换逻辑集中在 basename 部分,避免误动路径层级或扩展名。
- 只对匹配到的文件做处理,跳过目录(用
is_file()显式判断) - 扩展名必须保留原样,否则可能破坏 Web 服务或脚本可执行性
- 如果要替换空格为下划线,用
str_replace(' ', '_', $filename)比preg_replace更快更安全 - 注意中文、emoji 等多字节字符,确保脚本文件编码为 UTF-8,且 PHP 运行环境支持(
mb_internal_encoding('UTF-8')可选加固)
模拟运行时输出清晰的对比结果
光打印新名字不够,得让使用者一眼看出“哪里变了”。推荐格式:原路径 → 新路径,并高亮变化部分(比如用 加粗),但命令行里没法渲染 HTML,所以靠缩进和符号区分。
foreach (glob('./uploads/*.*') as $old) {
if (!is_file($old)) continue;
$info = pathinfo($old);
$new_basename = str_replace(' ', '_', $info['filename']);
$new = $info['dirname'] . '/' . $new_basename . '.' . $info['extension'];
echo "→ {$old}\n ↳ {$new}\n";
}
真正执行替换前必须检查路径权限和重名冲突
rename() 失败常见原因不是语法错,而是:目标文件已存在、源文件被占用、目录不可写、跨文件系统移动(Linux 下会失败)。模拟阶段就该把这些问题暴露出来。
立即学习“PHP免费学习笔记(深入)”;
- 用
file_exists($new)检查是否将覆盖已有文件 - 用
is_writable($info['dirname'])确认父目录可写 - 跨分区移动需先
copy()再unlink(),不能只靠rename() - Windows 下注意大小写不敏感,
ABC.jpg和abc.jpg视为同一文件,模拟时也应统一转小写比对
模拟这步省不了——文件名一旦批量覆写错,恢复成本远高于多跑一次脚本。










