PHP重命名文件只能用rename()函数操作本地或挂载路径；远程服务器需用对应协议方法（如FTP的ftp_rename、S3的copy+delete）；HTTP URL不能直接rename。

PHP 本身没有内置函数直接“替换文件名”，所谓“重命名”操作靠的是 rename() 函数，它本质是移动（含同目录改名）或跨目录移动文件。远程服务器上的文件名不能用 PHP 的 rename() 直接修改——除非你有该服务器的文件系统访问权限（比如通过 SSH、FTP 或挂载为本地路径）。

用 rename() 改本地或挂载路径下的文件名

这是最常用也最可靠的方案，但前提是 PHP 进程能读写目标路径。注意：rename() 在 Windows 和 Linux 下行为一致，但大小写敏感性取决于底层文件系统（Linux 默认敏感，Windows 不敏感）。

• 源路径和目标路径

  

  必须在同一个文件系统内才能原子完成；跨磁盘/分区可能失败（返回 false）
• 目标路径已存在且为非空目录时，rename() 会失败（PHP 8.1+ 报 Warning: rename(): Cannot rename directory over non-empty directory）
• 确保运行 PHP 的用户（如 www-data 或 nginx）对源目录有 r 权限，对目标父目录有 w 和 x 权限

if (rename('/var/www/uploads/photo.jpg', '/var/www/uploads/photo_v2.jpg')) {
    echo "改名成功";
} else {
    echo "改名失败，请检查权限或路径";
}

远程服务器文件名替换必须走协议层

如果文件在另一台服务器上（比如 S3、FTP 服务器、另一台 Nginx 主机），rename() 完全无效。你需要对应协议的客户端工具：

• FTP/SFTP：用 ftp_rename() 或 ssh2_sftp_rename()（需启用 ext-ftp 或 ext-ssh2）
• Amazon S3：用 AWS SDK for PHP 的 $s3->copyObject() + $s3->deleteObject() 模拟重命名（S3 无原生命令）
• WebDAV：用 cURL 发送 MOVE 请求，Location 头指定新 URI

例如 FTP 重命名：

立即学习“PHP免费学习笔记（深入）”；

$conn = ftp_connect('ftp.example.com');
ftp_login($conn, 'user', 'pass');
if (ftp_rename($conn, '/old/name.txt', '/new/name.txt')) {
    echo "FTP 文件已重命名";
}
ftp_close($conn);

常见错误：把 URL 当成本地路径

下面这段代码一定失败：

rename('https://example.com/file.txt', 'https://example.com/file_new.txt'); // ❌ 错误！

因为 rename() 只接受本地文件系统路径（或已挂载的远程路径，如 NFS/CIFS）。浏览器或 curl 能打开的 HTTP 地址不是文件路径，PHP 不会发起 HTTP 请求去“改名”。遇到这种写法，基本说明混淆了「资源地址」和「文件位置」。

如果你看到 “No such file or directory” 或 “Permission denied”，优先检查：is_writable(dirname($target)) 是否为 true，而不是急着加 chmod 命令——很多情况下是 SELinux、Open_basedir 限制或容器挂载权限没放开。