(PHP 4, PHP 5, PHP 7)
rename — Renames a file or directory
$oldname
, string $newname
, resource $context
= ?
) : bool
Attempts to rename oldname
to
newname
, moving it between directories if necessary.
If renaming a file and newname
exists,
it will be overwritten. If renaming a directory and
newname
exists,
this function will emit a warning.
oldname
The old name.
Notă:
The wrapper used in
oldname
must match the wrapper used innewname
.
newname
The new name.
Notă: On Windows, if
newname
already exists, it must be writable. Otherwise rename() fails and issuesE_WARNING
.
context
Notă: 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.
Example #1 Example with rename()
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>