PHP递归重命名需用RecursiveDirectoryIterator遍历+rename()，注意路径必须完整、目标不可存在、跨平台大小写敏感，并用pathinfo分离文件名与扩展名安全替换。
用 rename() 逐个处理嵌套目录下的文件名
PHP 没有内置的「递归重命名」函数，必须自己遍历目录树。核心是组合 scandir() 或 RecursiveDirectoryIterator + rename()。直接对 rename() 传入旧路径和新路径即可，但要注意：源路径和目标路径都必须是**绝对路径或同级相对路径**，否则容易报错 Warning: rename(): No such file or directory。
常见错误是只改文件名没拼全路径，比如在子目录里执行 rename('old.txt', 'new.txt')，PHP 会默认在当前工作目录找 old.txt，而不是在子目录里。
- 务必用
realpath()或__DIR__拼出完整路径 - 目标文件名不能已存在，否则
rename()失败且不报错（返回false） - Windows 下注意大小写不敏感，Linux 下敏感，跨平台脚本要额外判断
用 RecursiveDirectoryIterator 安全遍历嵌套目录
比手动递归更可靠，能自动跳过 . 和 ..，也支持过滤文件/目录类型。关键点在于：迭代器返回的是 SplFileInfo 对象，要用 getPathname() 拿完整路径，getFilename() 拿原始文件名，再用 dirname() + 新文件名拼出目标路径。
如果要批量替换扩展名或前缀，建议先用 pathinfo() 拆解，避免字符串硬切导致出错。
立即学习“PHP免费学习笔记（深入）”；
foreach (new RecursiveIteratorIterator(new RecursiveDirectoryIterator('/path/to/root')) as $file) {
if ($file->isFile()) {
$oldPath = $file->getPathname();
$dir = $file->getPath();
$oldName = $file->getFilename();
$newName = str_replace('old_', 'new_', $oldName);
$newPath = $dir . '/' . $newName;
if ($oldPath !== $newPath && !file_exists($newPath)) {
rename($oldPath, $newPath);
}
}
}
替换时保留原扩展名、只动文件名主体
直接用 str_replace() 或 preg_replace() 替换整个文件名容易误伤扩展名，比如把 report_v2.pdf 改成 report_v3.pdf 时，若写成 str_replace('_v2', '_v3', $filename) 是安全的；但若想删掉所有下划线，str_replace('_', '', $filename) 就会把 data_log.txt 变成 datalog.txt —— 这未必是你想要的。
更稳妥的方式是分离文件名和扩展名：
- 用
pathinfo($filename, PATHINFO_FILENAME)提取不含扩展的部分 - 对这部分做替换，再用
pathinfo($filename, PATHINFO_EXTENSION)拼回去 - 注意
pathinfo()对无扩展名文件返回空字符串，需判断
$info = pathinfo($oldName);
$base = $info['filename'] ?? $oldName;
$ext = $info['extension'] ? '.' . $info['extension'] : '';
$newBase = str_replace('temp_', '', $base);
$newName = $newBase . $ext;
遇到权限拒绝或占用时怎么排查
rename() 返回 false 时，不等于失败原因只有「文件不存在」。常见真实原因是：Permission denied（目标目录不可写）、Operation not permitted（macOS 上 SIP 保护系统目录）、或 Windows 下文件正被其他进程打开（如 Excel 打开的 CSV）。
调试建议：
- 执行前加
var_dump(is_writable(dirname($newPath)), is_readable($oldPath)); - Windows 下用
handle.exe（Sysinternals 工具）查谁占用了文件 - Linux/macOS 下用
lsof +D /path/to/dir查打开句柄 - 避免在 Web 环境直接操作上传目录或日志目录，优先用 CLI 模式运行脚本
嵌套深、文件多时，别忘了设置 set_time_limit(0) 和 ini_set('memory_limit', '512M')，否则脚本中途退出也不报错。
