(PHP 4, PHP 5, PHP 7, PHP 8)
rename — Renames a file or directory
$from, string $to, ?resource $context = null): bool
Attempts to rename from to
to, moving it between directories if necessary.
If renaming a file and to exists,
it will be overwritten. If renaming a directory and
to exists,
this function will emit a warning.
fromThe old name.
Note:
The wrapper used in
frommust match the wrapper used into.
toThe new name.
Note: On Windows, if
toalready exists, it must be writable. Otherwise rename() fails and issuesE_WARNING.
contextA context stream resource.
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");
?>