(PHP 4, PHP 5, PHP 7, PHP 8)
rename — 重命名一个文件或目录
$from
, string $to
, ?resource $context
= null
): bool
尝试把 from
重命名为
to
,必要时会在不同目录间移动。
如果重命名文件时 to
已经存在,将会覆盖掉它。
如果重命名文件夹时
to
已经存在,本函数将导致一个警告。
from
原名
注意:
用于
from
中的封装协议必须和用于to
中的相匹配。
to
新的名字。
注意: 在 Windows 上,如果
to
已经存在,它必须是可写的。 否则 rename() 将失败,并导致E_WARNING
。
context
上下文流(context stream) resource。
成功时返回 true
, 或者在失败时返回 false
。
示例 #1 rename() 例子
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>