当前位置：首页 > 文章列表 > 文章 > php教程 > php代码示例如何批量重命名文件_php批量重命名文件代码示例【示例】

php代码示例如何批量重命名文件_php批量重命名文件代码示例【示例】

2026-05-03 19:41:37 0浏览收藏

珍惜时间，勤奋学习！今天给大家带来《php代码示例如何批量重命名文件_php批量重命名文件代码示例【示例】》，正文内容主要涉及到等等，如果你正在学习文章，或者是对文章有疑问，欢迎大家关注我！后面我会持续更新相关内容的，希望都能帮到正在学习的大家！

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() 也别依赖当前工作目录，一律用绝对路径。

避免直接操作 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()