如果用户指定的新名称已经存在，rename()函数将覆盖它。文件的旧名称和用户指定的新名称作为参数发送给rename()函数，成功时返回True，失败时返回False。

语法
rename(oldname,newname,context)
oldname
必需。规定要重命名的文件或目录。
newname
必需。规定文件或目录的新名称。
context
可选。规定文件句柄的环境。context 是可修改流的行为的一套选项。
错误和异常
1.在重命名目录时，如果新名称已经存在，则rename会生成一个警告。
2.oldname中使用的包装器必须与newname中使用的包装器匹配。
3.如果目标文件系统不允许对文件执行chown()或chmod()系统调用，那么rename()函数可能会生成警告。
示例一

<?php  
$old_name = "gfg.txt" ;  
$new_name = "newgfg.txt" ;  
rename($old_name, $new_name) ; 
?>

<?php
$old_name = "gfg.txt" ;
$new_name = "newgfg.txt" ; 
// 检查文件是否已经存在
if (!file_exists($old_name)) {
    // echo "文件$old_name不存在";
	echo "文件 $old_name 不存在";
} elseif (file_exists($new_name)) {
    echo "重命名 $old_name 时出错" ;
} else {
    if (rename($old_name, $new_name)) {
        echo "成功地将 $old_name 重命名为 $new_name" ;
    } else {
        echo "具有相同名称的文件已经存在" ;
    } 
}
?>