(PHP 4, PHP 5, PHP 7, PHP 8)
rename — Переименовывает файл или директорию
Пытается переименовать from в
to, перенося файл между директориями, если необходимо.
Если to существует, то он будет перезаписан. При переименовании
директории с существующим to будет выведено предупреждение.
fromСтарое имя.
Замечание:
Обёртка, используемая в
fromдолжна совпадать с обёрткой, используемой вto.
toНовое имя.
Замечание: В Windows, если
toуже существует, он должен быть доступен для записи. В противном случае rename() завершится ошибкой и выдастE_WARNING.
contextРесурс (resource) контекста потока.
Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.
Пример #1 Пример использования функции rename()
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>