(PHP 3, PHP 4 )
Attempts to rename oldname to newname.
Returns TRUE on success or FALSE on failure.
Example 1. Example with rename()
<?php rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt"); ?>
Note: Prior to PHP 4.3.3, rename() could not rename files across partitions on *nix based systems.
See also copy(), unlink(), and move_uploaded_file().