rename()是PHP重命名文件唯一推荐方式，需用绝对路径、确保目标目录可写、显式判断返回值并记录错误，中文名建议用英文存储+映射，通知用户依赖HTTP响应或前端轮询。

PHP 文件名替换用 rename() 最直接

PHP 本身没有“重命名文件”的高级封装，rename() 就是标准且唯一推荐的方式。它原子性强、跨平台（Linux/Windows 都支持），只要权限和路径合法就能生效。

常见错误现象：rename(): No such file or directory 多半是源路径写错（比如漏了目录前缀或用了相对路径但当前工作目录不对）；Permission denied 则是目标目录不可写，或源文件被其他进程锁定（如正在被 fopen('r+') 打开未关闭）。

• 源路径和目标路径必须是完整路径（建议用 __DIR__ . '/uploads/old.jpg' 而非 'uploads/old.jpg'）
• 目标目录必须已存在且有写权限（is_writable($target_dir) 建议提前检查）
• 如果只是改扩展名（如 .tmp → .jpg），确保 Web 服务器允许该扩展被访问（尤其 Nginx/Apache 的 MIME 或限制规则）

替换失败时别静默吞掉错误

直接调用 rename() 返回布尔值，不抛异常，所以必须显式判断。很多开发者习惯性忽略返回值，导致文件“消失”却无提示。

if (!rename($old_path, $new_path)) {
    $error = error_get_last();
    error_log("rename failed: " . ($error['message'] ?? 'unknown'));
    // 后续可返回 JSON 错误或跳转提示页
    echo json_encode(['success' => false, 'message' => '文件重命名失败，请检查权限']);
    exit;
}

注意：error_get_last() 只捕获上一个 PHP 错误，不能替代日志系统。生产环境建议用 error_log() 记录具体路径和时间，方便排查。

通知用户要分场景：页面跳转 / AJAX / 前端轮询

所谓“通知”，本质是把 PHP 的执行结果同步给用户。没有统一方案，取决于你前端怎么发起请求：

• 表单提交后跳转：用 header('Location: success.php?file=' . urlencode($new_name))，在 success.php 中读取 GET 参数展示提示
• AJAX 请求（最常用）：PHP 返回 JSON，前端用 fetch().then() 解析 success 字段，再调用 alert() 或更新 DOM（比如显示绿色 toast）
• 大文件或耗时操作：PHP 先写入临时状态（如 file_put_contents('status.json', json_encode(['done' => false]))），前端用定时器轮询该文件，直到返回 done: true

关键点：PHP 不会主动“推”消息给浏览器，所有通知都依赖一次 HTTP 响应或后续客户端拉取。

中文文件名替换要小心编码和 URL 安全

如果原始文件名含中文（如 报告.pdf），直接传给 rename() 在 Linux 下常出错——因为 PHP 内部用字节流处理，而终端/浏览器可能用 UTF-8，文件系统可能是 locale 编码（如 GBK）。更稳妥的做法是：用英文名做存储，中文名仅用于展示。

• 生成新文件名时用哈希+扩展名：$new_name = md5($old_name . time()) . '.' . pathinfo($old_name, PATHINFO_EXTENSION);
• 数据库或 session 中记录映射关系：['md5abc123.pdf' => '报告.pdf']，下载时通过 ID 查原名并设 Content-Disposition: attachment; filename*=UTF-8''%E6%8A%A5%E5%91%8A.pdf
• 若坚持用中文名，确保整个链路（上传、存储、Web 服务配置）统一 UTF-8，Nginx 需加 charset utf-8;，Apache 加 AddDefaultCharset UTF-8

这个环节最容易被忽略，一出问题就是“文件名乱码”或“找不到文件”，但错误信息里完全不提编码。