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：

<?php  

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

输出：

1

代码示例2：

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

输出：

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