最稳妥的PHP批量改名方案是用rename()函数跨平台原子性重命名，需检查目标文件是否存在、权限及open_basedir限制，配合glob()和pathinfo()安全构造新名，务必dry-run测试并清理非法字符，且须同步更新代码中require/include路径。
用 rename() 批量改 PHP 文件名最稳妥
直接用 PHP 的 rename() 函数，不依赖 shell 或外部命令，跨平台（Windows/Linux/macOS）都可靠。它原子性重命名，失败会返回 false，不会出现“改一半”的情况。
关键点：必须确保目标路径不存在同名文件，且当前用户对源和目标目录都有写权限；PHP 进程不能在 open_basedir 限制里堵死路径。
- 先用
glob('*.php')或scandir()获取待处理文件列表 - 逐个构造新文件名，推荐用
pathinfo()拆解原名，避免手动字符串截取出错 - 调用
rename($old, $new)前加file_exists($new)判断，防止覆盖 - 记录成功/失败的文件，便于回溯
小批量测试必须加 dry-run 模式
别一上来就 rename()。先模拟执行，只打印“将把 A.php 改成 B.php”，确认逻辑无误再开真刀。
所谓 dry-run 就是把 rename() 换成 echo 或日志输出，并跳过实际操作。哪怕只测 3 个文件，也要走完完整流程——包括路径拼接、大小写转换、特殊字符过滤等。
立即学习“PHP免费学习笔记（深入）”；
foreach (glob('test_*.php') as $file) {
$info = pathinfo($file);
$newName = 'prod_' . $info['filename'] . '.php';
$newPath = $info['dirname'] . '/' . $newName;
// dry-run：只显示，不执行
echo "DRY-RUN: rename('{$file}', '{$newPath}')\n";
// 真实运行时才取消下面这行注释
// if (!rename($file, $newPath)) {
// echo "FAIL: {$file} → {$newPath}\n";
// }}
文件名含空格或中文时要用 urlencode() 吗？
不用。PHP 的 rename() 原生支持 UTF-8 编码的文件名（前提是文件系统本身支持，如 ext4、NTFS）。但要注意：PHP 脚本文件自身编码必须是 UTF-8 无 BOM，否则中文变量名或字符串字面量可能解析失败。
真正要防的是非法字符（如 / \ : * ? " |），尤其 Windows 下。建议统一用正则清理：
-
preg_replace('/[\\\\/:*?"|\\s]+/', '_', $basename)替换非法字符为空格或下划线 - 避免生成以
.开头的文件名（如.php），Linux 下会被当隐藏文件，某些脚本会跳过 - 如果原文件名有重复前缀（如
old_v1_index.php），用str_replace()比正则更安全
替换后 require/include 路径报错怎么办
文件名改了，但代码里 require 'old_file.php' 还没更新，运行时直接 Fatal error: require(): Failed opening required。这不是重命名工具的问题，而是必须同步处理代码引用。
简单项目可 grep 全局搜索：grep -r "old_file\.php" ./ --include="*.php"；复杂项目建议用 IDE 的「重命名符号」功能（如 PhpStorm 的 Shift+F6），它能自动更新所有引用。
注意：include_once 和 require_once 的缓存行为不会因文件名改变而失效，但只要路径错了，照样报错——别指望 opcode 缓存帮你绕过。
批量改名只是第一步，引用路径是否同步更新，才是上线前最容易被跳过的环节。
