PHP用array_map批量替换文件名函数详解

不可行。array_map仅用于纯函数式映射，如生成新文件名；批量重命名必须用foreach显式遍历，配合rename()、异常处理与状态反馈，确保路径验证、错误隔离和操作可审计。

PHP 中用 array_map 批量重命名文件可行吗？

不可行。这不是 array_map 的职责，它只是对数组元素做映射变换，不执行任何 I/O 操作。直接拿它调用 rename() 虽然语法上能跑通，但属于误用：既掩盖了副作用（文件系统变更），又无法捕获单个失败、缺乏错误隔离。

真正安全批量重命名文件的正确姿势

必须显式遍历 + 异常处理 + 状态反馈。核心是把「路径计算」和「文件操作」拆开，先验证再执行：

• array_map 只用于生成新文件名（纯函数式），比如：array_map(fn($f) => preg_replace('/\.txt$/', '.bak', $f), $files)
• 真实重命名必须用 foreach + rename()，并检查返回值或捕获 Warning
• 务必确认源文件存在、目标路径可写、目标名不冲突，否则 rename() 静默失败
• Windows 下大小写不敏感，rename('A.txt', 'a.txt') 会失败；Linux 下则可能成功但覆盖原文件

一个带校验和错误收集的实用示例

function batchRenameFiles(array $sourcePaths, callable $newNameGenerator): array
{
    $results = [];
    foreach ($sourcePaths as $src) {
        if (!is_file($src)) {
            $results[] = ['status' => 'skip', 'file' => $src, 'reason' => 'not exists'];
            continue;
        }
        $dst = $newNameGenerator($src);
        // 确保目录存在
        $dstDir = dirname($dst);
        if (!is_dir($dstDir) && !mkdir($dstDir, 0755, true)) {
            $results[] = ['status' => 'fail', 'file' => $src, 'reason' => "cannot create dir: $dstDir"];
            continue;
        }
        if (rename($src, $dst)) {
            $results[] = ['status' => 'ok', 'file' => $src, 'to' => $dst];
        } else {
            $results[] = ['status' => 'fail', 'file' => $src, 'reason' => 'rename() failed'];
        }
    }
    return $results;
}

// 用法：把当前目录下所有 .log 改成 .log.bak
$logs = glob('./logs/*.log');
$result = batchRenameFiles($logs, fn($p) => $p . '.bak');
print_r($result);

为什么别在 array_map 里调 rename()

因为 array_map 的设计契约是「无副作用」，而 rename() 是强副作用操作。后果包括：

• 一旦中间某个 rename() 失败，你无法知道是第几个出问题，也难 rollback
• 无法提前预判目标路径是否合法（比如含非法字符、超长、跨分区）
• PHP 8.0+ 开启 zend.assertions=1 时，部分环境会警告「impure function in pure context」
• 代码可读性差：看到 array_map 默认认为是数据转换，不是文件操作

真正要「批量」，重点不在函数名是否带 map，而在逻辑是否可中断、可审计、可恢复。文件系统操作永远比数组映射脆弱得多。