PHP rename() 函数
实例
重命名目录+文件:
<?php
rename("images","pictures");
rename("/test/file1.txt","/home/docs/my_file.txt");
?>
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 包装器一起使用。 |