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

# rename

(PHP 4, PHP 5, PHP 7, PHP 8)

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

### Описание

function rename(string `$from`, string `$to`, ?resource `$context` = `null`): bool

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

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

`from`

  Старое имя.

  > Замечание:

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

`to`

  Новое имя.

  > Замечание: В Windows, если `to` уже существует, он должен быть доступен для записи. В противном случае rename() завершится ошибкой и выдаст `E_WARNING`.

`context`
  Ресурс (resource) контекста потока.

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

Функция возвращает `true`, если выполнилась успешно, или `false`, если возникла ошибка.

### Примеры

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

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

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

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open