rename
(PHP 4, PHP 5, PECL zip:1.1.0-1.4.1)
rename — Переименовывает файл или директорию
Описание
Пытается переименовать oldname в newname .
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
Example#1 Пример использования функции rename()
<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>
Note: В версиях PHP ниже 4.3.3, функция rename() не могла переименовать файлы, находящиеся на другом разделе в ОС, основанных на *nix.
Note: Начиная с версии PHP 5.0.0, функция rename() также может быть использована с некоторыми обвёртками URL. Обратитесь к List of Supported Protocols/Wrappers для получения списка обвёрток, которые поддерживают rename().
Note: Обвёртка, используемая в oldname ОБЯЗАНА совпадать с обвёрткой, используемой в newname .
Note: Аттрибут context был добавлен начиная с версии PHP 5.0.0.
См. также описание функций copy(), unlink() и move_uploaded_file().