PHP中的rename()函数是一个内置函数，用于重命名文件或目录。它尝试用用户指定的新名称更改文件或目录的旧名称，并且在必要时可以在目录之间移动。

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

语法:

rename(oldname, newname, context)

参数的使用:

PHP中的rename()函数接受三个参数。

oldname:它是一个强制性参数，指定文件或目录的旧名称。

newname:它是一个强制参数，指定文件或目录的新名称。

context:它是一个可选参数，指定流的行为。

返回值:

成功时返回True，失败时返回False。

错误和异常

1.在重命名目录时，如果新名称已经存在，则rename会生成一个警告。

2.oldname中使用的包装器必须与newname中使用的包装器匹配。

3.如果目标文件系统不允许对文件执行chown()或chmod()系统调用，那么rename()函数可能会生成警告。

下面的程序演示了rename()函数。

假设有一个名为“gfg.txt”的文件

代码示例1：

1. <?php   
2.  
3. $old_name = "gfg.txt" ;   
4.  
5. $new_name = "newgfg.txt" ;   
6.  
7. rename( $old_name, $new_name) ;  
8.  
9. ?> 

输出：

1

代码示例2：

1. <?php   
2.  
3. $old_name = "gfg.txt" ;    
4.  
5. $new_name = "newgfg.txt" ;   
6.  
7. // 检查文件是否已经存在 
8.  
9. if(file_exists($new_name))  
10.  
11.  {   
12.  
13.    echo "重命名$old_name时出错" ;  
14.  
15.  }  
16.  
17. else 
18.  
19.  {  
20.  
21.    if(rename( $old_name, $new_name))  
22.  
23.      {   
24.  
25.         echo "成功地将 $old_name 重命名为 $new_name" ;  
26.  
27.      }  
28. //phpfensi.com 
29.      else 
30.  
31.      {  
32.  
33.         echo "具有相同名称的文件已经存在" ;  
34.  
35.      }  
36.  
37.   }  
38.  
39. ?> 

输出：

成功地将gfg.txt重命名为newgfg.txt