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


(PHP 4, PHP 5)

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

Описание

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");
?>

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

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