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() 记录具体路径和时间，方便排查。
立即学习“PHP免费学习笔记（深入）”；
通知用户要分场景：页面跳转 / 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
这个环节最容易被忽略，一出问题就是“文件名乱码”或“找不到文件”，但错误信息里完全不提编码。
