Переименовывает файл или директорию

Описание

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

Смотрите также

copy() - Копирует файл
unlink() - Удаляет файл
move_uploaded_file() - Перемещает загруженный файл в новое место