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 限制或容器挂载权限没放开。
