[函数]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()可能无法跨分区移动文件，因此最好在移动之前检查源文件和目标目录是否在同一分区。