   #PHP Manual Filesystem functions realpath rewind

   PHP Manual
   Prev  Next
   ______________________________________________________________________

                                    rename

   (PHP 3, PHP 4 )
   rename -- Renames a file

Description

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

   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.

     Note: As of PHP 5.0.0 rename() can also be used with some url
     wrappers. Refer to Appendix I for a listing of which wrappers
     support rename().

     Note: The wrapper used in oldname MUST match the wrapper used in
     newname.

     Note: The context parameter was added as of PHP 5.0.0.

   See also copy(), unlink(), and move_uploaded_file().
   ______________________________________________________________________

   Prev     Home   Next
   realpath  Up  rewind
