(PHP 4, PHP 5, PHP 7, PHP 8)
rename — 重命名一个文件或目录
$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");
?>