rename()
重命名或移动文件或目录
函数名称:rename()
适用版本:所有PHP版本
函数描述:rename()函数用于重命名或移动文件或目录。
语法:bool rename ( string $oldname , string $newname [, resource $context ] )
参数:
$oldname:需要重命名或移动的文件或目录的原始名称。
$newname:重命名或移动后的文件或目录的新名称。
$context(可选):用于指定上下文的资源,通常在流上下文中使用。
返回值:函数执行成功时返回true,失败时返回false。
示例1:重命名文件
$oldname = "oldfile.txt";
$newname = "newfile.txt";
if (rename($oldname, $newname)) {
echo "文件重命名成功!";
} else {
echo "文件重命名失败!";
}
示例2:移动目录
$oldname = "old_directory";
$newname = "new_directory";
if (rename($oldname, $newname)) {
echo "目录移动成功!";
} else {
echo "目录移动失败!";
}
注意事项:
$oldname和$newname可以是相对路径或绝对路径。
如果$newname已经存在,则将被覆盖。
无法跨文件系统进行重命名。
对于移动目录,如果新目录不存在,则会自动创建。
对于移动目录,需要具有足够的权限来访问源目录和目标目录。
在某些操作系统上,rename()可能无法在打开的文件上工作,因此最好在重命名之前关闭文件。
在某些操作系统上,rename()可能无法跨分区移动文件,因此最好在移动之前检查源文件和目标目录是否在同一分区。