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)