rename

(PHP 4, PHP 5, PHP 7)

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

Описание

rename ( string $oldname , string $newname , resource $context = ? ) : bool

Пытается переименовать oldname в newname, перенося файл между директориями, если необходимо. Если newname существует, то он будет перезаписан. При переименовании директории с существующим newname будет выведено предупреждение.

Список параметров

oldname

Старое имя.

Замечание:
Обёртка, используемая в oldname должна совпадать с обёрткой, используемой в newname.

newname

Новое имя.

Замечание: В Windows, если newname уже существует, он должен быть доступен для записи. В противном случае rename() завершится ошибкой и выдаст E_WARNING.

context

Замечание: Поддержка контекста была добавлена в PHP 5.0.0. Для описания контекстов смотрите раздел Потоки.

Возвращаемые значения

Возвращает true в случае успешного завершения или false в случае возникновения ошибки.

Примеры

Пример #1 Пример использования функции rename()


<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>

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

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