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

Описание

rename ( string $oldname , string $newname [, resource $context ] ) : bool

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

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

oldname: Старое имя.

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

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

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

Список изменений

Версия	Описание
5.3.1	rename() теперь может переименовывать файлы между дисками в Windows.

Примеры

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


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

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

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