PHP Manual

rename

PHP Manual
Prev		Next

rename

(PHP 3, PHP 4, PHP 5)

rename -- Renames a file or directory

bool rename ( string oldname, string newname [, resource context] )

Attempts to rename oldname to newname.

oldname: Note: The old name. The wrapper used in oldname must match the wrapper used in newname.
newname: The new name.
context: Note: Context support was added with PHP 5.0.0. For a description of contexts, refer to Reference CLX, Stream Functions.

Returns TRUE on success or FALSE on failure.

Version	Description
5.0.0	rename() can now also be used with some URL wrappers. Refer to Appendix O for a listing of which wrappers support rename().
4.3.3	rename() is now able to rename files across partitions on *nix based systems.

Example 1. Example with rename()


<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>

Prev	Home	Next
realpath	Up	rewind