rename
rename
(PHP 4, PHP 5, PHP 7)
rename - 重命名文件或目录
描述
bool rename ( string $oldname , string $newname [, resource $context ] )
尝试重命名oldname到newname，如果需要的话目录之间移动。如果重命名文件并newname存在，它将被覆盖。如果重命名目录并newname存在，此功能将发出警告。
参数
oldname
旧名称。
注意：使用的包装器oldname必须匹配中使用的包装器newname。
newname
新的名字。
context
注意：使用PHP 5.0.0添加了上下文支持。有关上下文的描述，请参阅流。
返回值
成功返回TRUE或失败时返回FALSE。
Changelog
| 版本 | 描述 |
|---|---|
| 5.3.1 | rename()现在可以在Windows中的驱动器中重命名文件。 |
| 5.0.0 | rename()现在也可以用于一些URL包装器。有关哪些包装器支持rename()的列表，请参阅支持的协议和包装器。 |
| 4.3.3 | 如果拥有适当的权限，rename()现在可以在基于* nix的系统上跨越分区重命名文件。如果目标文件系统不允许对文件进行chown()或chmod()系统调用，则可能会生成警告 - 例如，如果目标文件系统是FAT文件系统。 |
示例
Example #1 Example with rename()
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt"
?>
另请参阅
- copy() - 复制文件
- unlink() - 删除一个文件
- move_uploaded_file() - 将上传的文件移动到新位置
← realpath
rewind →
