rename

(PHP 4, PHP 5, PHP 7, PHP 8)

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

Описание

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

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

To Top