# 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");
?>`

### 参见

- copy() - 拷贝文件
- unlink() - 删除文件
- move_uploaded_file() - 将上传的文件移动到新位置

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open