(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");
?>