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