rename()

❮ PHP 文件系统参考手册

实例

重命名目录+文件:

<?php
rename("images","pictures");
rename("/test/file1.txt","/home/docs/my_file.txt");
?>

---

定义和用法

rename() 函数重命名文件或目录。

若成功，则该函数返回 true。若失败，则返回 false。

语法

rename(old, new, context)

参数值

参数	描述
old	必需。规定要重命名的文件或目录。
new	必需。规定文件或目录的新名称。
context	可选。规定文件句柄的环境。context 是可修改流的行为的一套选项。

---

提示和注释

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

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

注释:对 context 的支持是 PHP 5.0.0 添加的。

---

技术细节

返回值:	成功为 TRUE，失败为 FALSE
PHP 版本:	4.0+
PHP 更新日志:	PHP 5.3.1: 允许在 Windows 中跨驱动器重命名文件。 PHP 5.0:可与某些 URL 包装器一起使用。

---

❮ PHP 文件系统参考手册