PHP rename 文件系统函数

• 

  定义和用法

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

  版本支持

  PHP4	PHP5	PHP7
  支持	支持	支持

  5.3.1 可以在 Windows 上跨驱动器 rename() 文件。

  5.0.0 rename() 也可用于某些 URL 封装协议。参见支持的协议和封装协议 的列表看看 rename() 支持哪些 URL 封装协议。

  4.3.3 在有适当权限的时候 rename() 已经能够在基于 *nix 的系统中跨磁盘分区重命名文件。

• 

  语法

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

  尝试把 oldname 重命名为 newname。
• 

  参数

  参数	必需的	描述
  oldname	是	用于 oldname 中的封装协议必须和用于 newname 中的相匹配。
  newname	是	新的名字。
  content	否	在 PHP 5.0.0 中增加了对上下文（Context）的支持。

  注意： 尽管必须提供路径，但该值可以为空或NULL。在这些情况下，该值将解释为当前目录。

• 

  返回值

  成功时返回 TRUE， 或者在失败时返回 FALSE。
• 

  示例

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

• 

  相关函数

  copy() - 拷贝文件

  unlink() - 删除文件

  move_uploaded_file() - 将上传的文件移动到新位置