PHP批量重命名文件需校验目标存在、用绝对路径、防覆盖：先file_exists()检查，再rename()；路径用realpath()或__DIR__拼接；跨分区用copy()+unlink()；禁用shell_exec确保安全可控。
PHP rename() 批量重命名文件的正确写法
直接用 rename() 循环改名是可行的，但必须确保目标路径不存在同名文件，否则会静默失败或覆盖——这是最常踩的坑。
实际操作中建议先校验目标文件是否已存在，并统一使用绝对路径避免相对路径导致的定位错误：
-
rename()第二个参数（新路径）必须包含完整文件名，不能只传新文件名 - 源文件路径和目标路径都推荐用
realpath()或__DIR__ . '/files/'显式拼接 - 批量操作前加
if (file_exists($new_path)) { echo "冲突: $new_path"; continue; }
$files = glob(__DIR__ . '/old/*.txt');
foreach ($files as $old) {
$basename = basename($old, '.txt');
$new = __DIR__ . '/new/' . $basename . '_v2.txt';
if (!file_exists($new)) {
rename($old, $new) or die("重命名失败: $old -> $new");
}
}用 scandir() + pathinfo() 提取并重组文件名
当需要按规则重命名（比如把 report_20231001.log 改成 log_2023-10-01.txt），得靠 pathinfo() 拆解原名，再手动拼接扩展名。
注意：pathinfo() 返回的 extension 不带点，拼新名时要自己加 .；dirname() 也别依赖当前工作目录，一律用绝对路径。
立即学习“PHP免费学习笔记（深入）”；
- 避免直接操作
scandir()返回的.和..目录项，过滤掉它们 - 如果原文件名含中文或特殊符号，
urlencode()不适用，应保持原始字节不变（UTF-8 文件系统下通常没问题） - Windows 下长路径或保留字（如
CON,AUX）可能触发rename()失败，需额外检查
遇到“Permission denied”或“No such file or directory”怎么办
这两个错误不是代码逻辑问题，而是运行环境权限或路径配置问题。PHP 进程用户（如 www-data 或 nginx）必须对源目录有读+执行权，对目标目录有写+执行权。
- 用
is_readable($old)和is_writable(dirname($new))提前判断，比等rename()报错更可控 -
No such file or directory多半是目标父目录不存在，加一句mkdir(dirname($new), 0755, true)可解决 - 跨分区移动（比如从
/tmp到/home）在某些系统上会失败，rename()实际是复制+删除，此时需改用copy()+unlink()
为什么不用 shell_exec('mv')？
虽然 shell_exec('mv old/* new/') 看似简洁，但它绕过了 PHP 的错误捕获机制，无法知道哪几个文件没挪成功，也没法做原子性校验。更重要的是：服务器禁用执行函数（disable_functions=shell_exec）很常见，线上环境基本不可用。
真正需要高性能大批量时，应该分批处理（比如每次 100 个），并记录日志到文件而不是靠屏幕输出——因为 CLI 超时或 Web 请求中断后，你根本不知道卡在哪一步。
路径拼接、权限校验、冲突预防这三步漏掉任何一环，批量重命名就容易变成“删库跑路”的前奏。
