(PHP 4, PHP 5, PHP 7, PHP 8)
rename — Переименовывает файл или директорию
$from
, string $to
, ?resource $context
= null
): bool
Пытается переименовать 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");
?>