PHP rename( )用法及代碼示例

PHP中的rename()函數是一個內置函數，用於重命名文件或目錄。它嘗試使用用戶指定的新名稱來更改文件或目錄的舊名稱，並且如有必要，它可能會在目錄之間移動。
如果用戶指定的新名稱已經存在，則rename()函數將其覆蓋。文件的舊名稱和用戶指定的新名稱將作為參數發送到rename()函數，並且成功時返回True，失敗時返回False。

用法:

rename(oldname, newname, context)

使用的參數：
PHP中的rename()函數接受三個參數。

1. oldname:它是必填參數，用於指定文件或目錄的舊名稱。
2. newname:它是必填參數，用於指定文件或目錄的新名稱。
3. context:它是一個可選參數，用於指定流的行為。

返回值：
成功返回True，失敗返回False。

錯誤與異常

1. 如果重命名目錄時新名稱已經存在，則rename()函數將生成警告。
2. 舊名稱中使用的包裝必須與新名稱中使用的包裝匹配。
3. 如果目標文件係統不允許在文件上進行chown()或chmod()係統調用，則rename()函數可能會生成警告。

例子：

Input:$old_name = "gfg.txt" ; 
        $new_name = "newgfg.txt" ; 
        rename( $new_name, $old_name) ;

Output:1

Input:$old_name = "gfg.txt" ;
        $new_name = "newgfg.txt" ; 
        if(file_exists($new_name))
        { 
           echo "Error While Renaming $old_name" ;
        }
        else
        {
           if(rename( $old_name, $new_name))
           { 
           echo "Successfully Renamed $old_name to $new_name" ;
           }
          else
          {
           echo "A File With The Same Name Already Exists" ;
          }
        }

Output:Successfully Renamed gfg.txt to newgfg.txt

以下示例程序旨在說明rename()函數。

假設有一個名為“gfg.txt”的文件

程序1:

<?php  
// Old Name Of The file 
$old_name = "gfg.txt" ;  
  
// New Name For The File 
$new_name = "newgfg.txt" ;  
  
// using rename() function to rename the file 
rename( $old_name, $new_name) ; 
  
?>

輸出：

1

程序2:

<?php  
// Old Name Of The file 
$old_name = "gfg.txt" ;  
   
// New Name For The File 
$new_name = "newgfg.txt" ;  
   
// Checking If File Already Exists 
if(file_exists($new_name)) 
 {  
   echo "Error While Renaming $old_name" ; 
 } 
else
 { 
   if(rename( $old_name, $new_name)) 
     {  
        echo "Successfully Renamed $old_name to $new_name" ; 
     } 
     else
     { 
        echo "A File With The Same Name Already Exists" ; 
     } 
  } 
?>

輸出：

Successfully Renamed gfg.txt to newgfg.txt

相關文章：

• PHP - copy( )用法及代碼示例
• PHP - unlink()用法及代碼示例

參考：
http://php.net/manual/en/function.rename.php