Php/docs/function.rename

• PHP Manual
• 文件系统函数
• 重命名一个文件或目录

rename

(PHP 4, PHP 5, PHP 7)

rename — 重命名一个文件或目录

说明

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

尝试把 oldname 重命名为 newname，必要时会在不同目录间移动。 如果重命名文件时 newname 已经存在，将会覆盖掉它。 如果重命名文件夹时 newname 已经存在，本函数将导致一个警告。

参数

oldname

原名

Note:

用于 oldname 中的封装协议必须和用于 newname 中的相匹配。

newname

新的名字。

Note:

在 Windows 上如果 newname 已经存在，它必须被覆盖。否则 rename() 将失败并导致 E_WARNING。

context

Note: 在 PHP 5.0.0

中增加了对上下文（Context）的支持。有关上下文（Context）的说明参见

Streams。

返回值

成功时返回 true， 或者在失败时返回 false。

范例

Example #1 rename() 例子

<?phprename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");?>

参见

• copy() - 拷贝文件
• unlink() - 删除文件
• move_uploaded_file() - 将上传的文件移动到新位置