(PHP 4, PHP 5)
rename — Renames a file or directory
$oldname
, string $newname
[, resource $context
] )
Attempts to rename oldname to
newname, moving it between directories if necessary.
If newname exists, it will be overwritten.
oldname
Notă:
The old name. The wrapper used in
oldnamemust match the wrapper used innewname.
newnameThe new name.
contextNotă: Susținrea contextelor a fost adăugată începând cu PHP 5.0.0. Pentru o descriere a contextelor, referiți-vă la Streams.
Întoarce valoarea TRUE în cazul
succesului sau FALSE în cazul eșecului.
| Versiunea | Descriere |
|---|---|
| 5.3.1 | rename() can now rename files across drives in Windows. |
| 5.0.0 | rename() can now also be used with some URL wrappers. Refer to Supported Protocols and Wrappers for a listing of which wrappers support rename(). |
| 4.3.3 | rename() 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. |
Example #1 Example with rename()
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>