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

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

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

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

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

Версия	Описание
5.3.1	rename() теперь может переименовывать файлы между дисками в Windows.
5.0.0	rename() теперь также может быть использована с некоторыми обёртками URL. Обратитесь к Поддерживаемые протоколы и обработчики (wrappers) для получения списка обёрток, которые поддерживают rename().
4.3.3	rename() теперь может перемещать/переименовать файлы, находящиеся на другом разделе в ОС, основанных на nix, подразумевая, что предоставлены соответствующие права на эти файлы. Могут быть сгенерировано предупреждение, если результирующая файловая система не позволяет совершать на файлах системные вызовы chown()* или chmod() — например, если результирующей файловой системой является FAT.

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


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