Файловая система
PHP Manual

rename

(PHP 4, PHP 5, PHP 7)

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

Описание

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

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

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

oldname

Старое имя.

Замечание:

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

newname

Новое имя.

context

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

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

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

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

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

Примеры

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

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

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


Файловая система
PHP Manual