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() 例子

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

参见