17370845950

最简可靠方式是直接用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，它们不缓存全量文件名，边读边处理：

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 自行遍历

实际跑通的关键不在“怎么写”，而在确认源目标是否同分区、Windows 是否有进程锁、日志是否留痕可回溯。这些地方一漏，GB 级目录重命名中途失败，恢复成本远高于预防成本。