最简可靠方式是直接用PHP原生rename()函数，因其原子性、跨平台且不依赖外部命令；同分区下为毫秒级inode重映射，跨分区则退化为copy+unlink需手动处理。
PHP rename() 替换文件名最简可靠方式
直接用 rename() 是 PHP 原生、原子性、跨平台（Linux/Windows）的唯一推荐方案，不依赖 shell 或外部命令，也不会因权限或符号链接出错。
常见错误是先 unlink() 再 copy()，这既非原子操作（中途失败会丢数据），又慢且占双倍磁盘空间。而 rename() 在同分区下本质是 inode 重映射，毫秒级完成，哪怕 GB 级文件也一样快。
- 目标路径必须与源路径在
同一文件系统，否则rename()会退化为 copy+unlink，此时需手动检查返回值并处理失败 - 目标文件已存在时，
rename()会直接覆盖（Linux 默认行为；Windows 下若目标只读则失败） - 确保运行 PHP 的用户对源目录和目标目录都有
write和execute权限（后者用于进入目录）
批量重命名大目录：避免内存爆掉的关键点
用 scandir() 一次性读取上万文件会吃光内存，尤其在低配服务器上。正确做法是流式遍历 + 分批处理。
优先选 DirectoryIterator 或 glob() 配合 GLOB_NOSORT，它们不缓存全量文件名，边读边处理：
立即学习“PHP免费学习笔记（深入）”；
foreach (new DirectoryIterator('/path/to/dir') as $file) {
if ($file->isFile() && preg_match('/^old_prefix_(\d+)\.log$/', $file->getFilename(), $m)) {
$newName = '/path/to/dir/new_prefix_' . $m[1] . '.log';
rename($file->getPathname(), $newName);
}
}
-
opendir()+readdir()更轻量，但需手动跳过.和.. - 绝对不要用
shell_exec('ls | sed | xargs mv')—— 文件名含空格、换行、特殊字符时必然崩溃 - 若需按修改时间排序再重命名，用
array_map()+filemtime()只取必要字段，别把整个stat结构全加载
Windows 下 rename() 失败的三个典型原因
PHP 在 Windows 上调用 rename() 报 Permission denied 或 Access is denied，基本锁定以下三类：
- 目标文件被其他进程占用（如记事本、Excel、杀毒软件实时扫描）—— 用
Process Explorer查句柄，或加usleep(10000)重试 3 次 - 目标路径含非法字符（
: " / \ | ? *）或长度超260字符 —— 用mb_strlen()校验，长路径前加\\?\前缀（仅限绝对路径） - 源或目标在 NTFS 压缩/加密属性目录中 ——
exec('attrib -C -E "C:\path"')清除属性后再试
大文件目录重命名后如何验证一致性
重命名本身不校验内容，但用户常误以为“名字变了内容就变了”。真正要防的是意外覆盖或漏处理。
简单有效的方式是比对重命名前后的文件数量与大小总和（不用哈希，太慢）：
$before = array_sum(array_map('filesize', glob('/old/*.txt')));
$after = array_sum(array_map('filesize', glob('/new/*.txt')));
if ($before !== $after) {
error_log("Size mismatch: before={$before}, after={$after}");
}
- 用
md5_file()校验关键小文件（如配置、索引），但绝不用它扫整个目录 - 记录原始文件名列表到临时
.log，重命名完成后用diff对比，比代码逻辑更可信 - 如果目录结构复杂（含子目录），
rename()不递归 —— 必须用RecursiveDirectoryIterator自行遍历
