PHP 手册
后退 |  | 前进

# rename

(PHP 3, PHP 4, PHP 5)

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

## 说明

bool rename ( string oldname, string newname [, resource context] )

尝试把 oldname 重命名为 newname。

如果成功则返回 `TRUE`，失败则返回 `FALSE`。

例子 1. rename() 例子

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

> 注: 在 PHP 4.3.3 之前，rename() 不能在基于 *nix 的系统中跨磁盘分区重命名文件。

> 注: 自 PHP 5.0.0 起 rename() 也可用于某些 URL 封装协议。参见附录 L 的列表看看 rename() 支持哪些 URL 封装协议。

> 注: 用于 oldname 中的封装协议必须和用于 newname 中的相匹配。

> 注: 对 context 的支持是 PHP 5.0.0 添加的。有关 context 的说明请参考参考 CXLI, Stream Functions。

参见 copy()，unlink() 和 move_uploaded_file()。

后退 | 起点 | 前进
realpath | 上一级 | rewind