(PHP 4, PHP 5)
rename — Renames a file or directory
Attempts to rename oldname to newname.
The old name. The wrapper used in oldname must match the wrapper used in newname.
The new name.
Note: Context support was added with PHP 5.0.0. For a description of contexts, refer to Stream Functions.
Returns TRUE on success or FALSE on failure.
|5.3.1||rename() can now rename files across drives in Windows.|
|5.0.0||rename() can now also be used with some URL wrappers. Refer to Supported Protocols and Wrappers for a listing of which wrappers support rename().|
|4.3.3||rename() may now be able to rename files across partitions on *nix based systems, provided the appropriate permissions are held. Warnings may be generated if the destination filesystem doesn't permit chown() or chmod() system calls to be made on files — for example, if the destination filesystem is a FAT filesystem.|
Example #1 Example with rename()