Руководство по PHP
Пред. |  | След.

# rename

(PHP 3, PHP 4, PHP 5)

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

## Описание

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

Пытается переименовать oldname в newname.

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

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

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

> Замечание: В версиях PHP ниже 4.3.3, функция rename() не могла переименовать файлы, находящиеся на другом разделе в ОС, основанных на *nix.

> Замечание: Начиная с версии PHP 5.0.0, функция rename() также может быть использована с некоторыми обвёртками URL. Обратитесь к Прил. M для получения списка обвёрток, которые поддерживают rename().

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

> Замечание: Аттрибут context был добавлен начиная с версии PHP 5.0.0.

См. также описание функций copy(), unlink() и move_uploaded_file().

Пред. | Начало | След.
realpath | Уровень выше | rewind