rename

(PHP 4, PHP 5, PHP 7, PHP 8)

rename重命名一个文件或目录

说明

rename(string $oldname, string $newname, resource $context = ?): bool

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

参数

oldname

原名

注意:

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

newname

新的名字。

注意: 在 Windows 上,如果 newname 已经存在,它必须是可写的。 否则 rename() 将失败,并导致 E_WARNING

context

注意: 在 PHP 5.0.0 中增加了对上下文(Context)的支持。有关上下文(Context)的说明参见 Streams

返回值

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

范例

示例 #1 rename() 例子

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

参见