bool rename(string $oldname, string $newname[, resource $context])
Attempts to rename
newname, moving it between directories if necessary. If
newname exists, it will be overwritten.
TRUE on success or
FALSE on failure.
- string $oldname:
The old name. The wrapper used in
oldnamemust match the wrapper used in
- string $newname: The new name.
- resource $context:
Note: Context support was added with PHP 5.0.0. For a description of contexts, refer to Streams.
Example #1 Example with rename()
- The old name. The wrapper used in oldname must match the wrapper used in newname.
- Context support was added with PHP 5.0.0. For a description of contexts, refer to Streams.
|5.3.1||rename() can now rename files across drives in Windows.|
|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.|