rename

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

rename — 重命名一个文件或目录

rename(string $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");
?>