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. //Vevb.com 
29.      else 
30.  
31.      {  
32.  
33.         echo "具有相同名稱的文件已經存在" ;  
34.  
35.      }  
36.  
37.   }  
38.  
39. ?> 

輸出：

成功地將gfg.txt重命名為newgfg.txt