Php tutorial rename () function
Php filesystem Function
Definition and usage
Rename () function rename a file or directory.
If the call succeeds, the function returns true. If it fails, false is returned.
Syntax
rename(oldname,newname,context)
| Parameters |
Description |
| Oldname |
Required. Specifies the file or directory to be renamed. |
| Newname |
Required. Specifies the new name of the file or directory. |
| Context |
Required. Specifies the file handle environment. Context is a set of options for modifying stream behavior. |
Tips and comments
Note: Before php 4.3.3, rename () cannot rename files across Disk Partitions In * nix-based systems.
Note: encapsulation protocol used in oldnameRequiredMatches with newname.
Note: The support for context is added in php 5.0.0.
Example
Oldpath ---- original path of the file or directory
$ Newpath ---- new definition path
Rename ($ oldpath, $ newpath) can be used to move the file/directory.
After my tests, both win32 and unix php4 support this function.
In addition, it seems that the win32 version of php4 has canceled the unlink () function. You can also use the rename () function to delete objects. For example:
$ Path ---- file or directory path
$ Tmp ---- tmp directory (/tmp)
Use rename ($ path, $ tmp) to move the file to the tmp directory.