PHP | 重命名()函数

介绍

PHP中的rename()函数可以用于将一个文件或目录重命名。这个函数接受两个参数，第一个参数为原始文件或目录的名称，第二个参数为新名称。

语法

bool rename ( string $oldname , string $newname [, resource $context ] )

参数说明

• $oldname：原始文件或目录的名称。
• $newname：新名称。
• $context：可选参数，可以用来指定PHP流的上下文。

返回值

rename()函数返回布尔值，表示文件或目录是否重命名成功。

如果重命名成功，则返回true；否则返回false并产生一个E_WARNING错误。

示例

<?php
if (rename("oldfile.txt", "newfile.txt")) {
    echo "文件重命名成功";
} else {
    echo "文件重命名失败";
}
?>

注意事项

• rename()函数可用于重命名文件或目录。
• 如果要重命名文件或目录，必须有对这个文件或目录的写权限。
• 如果新名称中的路径与原始路径不同，则重命名后的文件或目录将位于新路径下。
• 如果rename()函数的第一个参数和第二个参数指向的是相同的文件或目录，则rename()函数什么也不做，并返回true。