RENAME(3)								 1								 RENAME(3)

rename - Renames a file or directory

SYNOPSIS
bool rename (string $oldname, string $newname, [resource $context]) DESCRIPTION
Attempts to rename $oldname to $newname, moving it between directories if necessary. If $newname exists, it will be overwritten. PARAMETERS
o $oldname - Note The old name. The wrapper used in $oldname must match the wrapper used in $newname. o $newname - The new name. o $context - Note Context support was added with PHP 5.0.0. For a description of contexts, refer to "Streams". RETURN VALUES
Returns TRUE on success or FALSE on failure. CHANGELOG
+--------+---------------------------------------------------+ |Version | | | | | | | Description | | | | +--------+---------------------------------------------------+ | 5.3.1 | | | | | | | rename(3) can now rename files across drives in | | | Windows. | | | | | 5.0.0 | | | | | | | rename(3) can now also be used with some URL | | | wrappers. Refer to "Supported Protocols and Wrap- | | | pers" for a listing of which wrappers support | | | rename(3). | | | | | 4.3.3 | | | | | | | rename(3) 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. | | | | +--------+---------------------------------------------------+ EXAMPLES
Example #1 Example with rename(3) <?php rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt"); ?> SEE ALSO
copy(3), unlink(3), move_uploaded_file(3). PHP Documentation Group RENAME(3)