PHP rename函数使用详解(php重命名文件)
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" ;
- }
- //phpfensi.com
- else
- {
- echo "具有相同名称的文件已经存在" ;
- }
- }
- ?>
输出:
成功地将gfg.txt重命名为newgfg.txt