(PHP 4, PHP 5, PHP 7)
rename — 重命名一个文件或目录
$oldname
, string $newname
[, resource $context
] ) : bool
尝试把 oldname 重命名为
newname，必要时会在不同目录间移动。
如果重命名文件时 newname 已经存在，将会覆盖掉它。
如果重命名文件夹时
newname 已经存在，本函数将导致一个警告。
oldname原名
Note:
用于
oldname中的封装协议必须和用于newname中的相匹配。
newname新的名字。
Note: 在 Windows 上如果
newname已经存在，它必须被覆盖。否则 rename() 将失败并导致E_WARNING。
contextNote: 在 PHP 5.0.0 中增加了对上下文（Context）的支持。有关
上下文（Context）的说明参见 Streams。
成功时返回 TRUE， 或者在失败时返回 FALSE。
Example #1 rename() 例子
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>