PHP |重命名( )函数

PHP的 rename()函数是一个内置函数，用于重命名文件或目录。它尝试使用用户指定的新名称更改文件或目录的旧名称，并且可能会在必要时在目录之间移动。
如果用户指定的新名称已经存在，则 rename()函数覆盖它。文件的旧名称和用户指定的新名称作为参数发送到 rename()函数，成功时返回 True，失败时返回 False。

句法：

rename(oldname, newname, context)

使用的参数：
PHP的 rename()函数接受三个参数。

1. oldname ：它是一个强制参数，用于指定文件或目录的旧名称。
2. newname ：它是一个强制性参数，用于指定文件或目录的新名称。
3. context：它是一个可选参数，用于指定流的行为。

返回值：
它在成功时返回 True，在失败时返回 False。

错误和异常

1. 如果在重命名目录时新名称已存在，则 rename()函数生成警告。
2. oldname 中使用的包装器必须与 newname 中使用的包装器匹配。
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

方案二

输出：

Successfully Renamed gfg.txt to newgfg.txt

相关文章：

• PHP |复制( )函数
• PHP | unlink()函数

参考：
http:// PHP.net/manual/en/函数.rename。 PHP