(PHP 4, PHP 5)
rename — Renames a file or directory
Attempts to rename
newname, moving it between directories if necessary.
newname exists, it will be overwritten.
The old name. The wrapper used in
oldnamemust match the wrapper used in
The new name.
Note: Context support was added with PHP 5.0.0. For a description of contexts, refer to Streams.
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()