array_walk不能递归遍历目录，仅能操作已有数组；真正递归需用RecursiveDirectoryIterator或手动递归函数，否则子目录文件被忽略、编码和权限问题易导致重命名失败。
PHP递归遍历目录并批量重命名文件
直接说结论：用 array_walk 本身不能递归遍历目录，它只操作数组；真正做递归目录遍历得靠 RecursiveDirectoryIterator 或手动写递归函数。强行套 array_walk 反而绕路、难调试、不直观。
为什么 array_walk 不适合递归重命名文件
array_walk 是对已有数组的每个元素执行回调，它不生成目录结构、不读取磁盘、不处理路径层级。你得先拿到所有文件路径数组，才能传给它——那“怎么拿到这个数组”才是关键难点，而这一步恰恰需要真正的递归或迭代器支持。
- 常见错误：把
scandir()的结果（仅当前层）丢给array_walk，结果子目录里的文件完全被忽略 - 更隐蔽的问题：文件名含中文、空格或特殊符号时，
array_walk回调里不做urlencode或mb_convert_encoding处理，rename()直接失败且报错不明显 - 性能隐患：一次性把几万条路径读进内存再走
array_walk，不如边遍历边处理省内存
推荐做法：用 RecursiveIteratorIterator + rename()
这是 PHP 原生最稳的递归重命名方案，兼顾可读性、健壮性和对 Unicode 路径的支持。
function renameFilesInDir($root, $oldName, $newName) {
$iterator = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($root, FilesystemIterator::SKIP_DOTS),
RecursiveIteratorIterator::SELF_FIRST
);
foreach ($iterator as $file) {
if (!$file->isFile()) continue;
$path = $file->getPathname();
$basename = $file->getBasename();
// 只替换文件名（不含扩展名）部分，保留后缀
$info = pathinfo($basename);
$newBasename = str_replace($oldName, $newName, $info['filename']) . '.' . ($info['extension'] ?? '');
if ($newBasename !== $basename) {
$newPath = dirname($path) . '/' . $newBasename;
// 确保目标路径不存在，避免覆盖
if (!file_exists($newPath)) {
rename($path, $newPath);
}
}
}
}
// 使用示例：把当前目录下所有文件名中的 "draft" 替换为 "final"
renameFilesInDir(__DIR__, 'draft', 'final');
如果坚持用自定义递归函数 + array_walk 配合
仅当已有现成的文件路径数组（比如从数据库查出、或 API 返回），才考虑用 array_walk 批量 rename。此时它只是个“执行器”，不是“发现器”。
立即学习“PHP免费学习笔记（深入）”；
- 必须确保路径数组里的每项都是完整绝对路径，相对路径在
array_walk回调里容易因工作目录变化出错 - 记得加错误检查：
if (rename($old, $new) === false) { error_log("rename failed: $old -> $new"); } - Windows 下注意大小写不敏感，
str_replace可能误替大小写变体，要用str_ireplace - 不要在
array_walk回调里修改原数组键名或结构，rename 本身不依赖数组键，改了也没用
真正卡住人的从来不是 rename 这一行代码，而是路径是否真实存在、编码是否一致、权限是否允许、目标名是否已占用——这些细节在递归层级深的时候会指数级放大。别省那几行 iterator 代码。
