Рекурсивный акроним словосочетания «PHP: Hypertext Preprocessor»
Добро пожаловать на форум PHP программистов!
За последние 24 часа нас посетили 17835 программистов и 1605 роботов. Сейчас ищут 1286 программистов ...
rename - Переименовывает файл или директорию
Вернуться к: Файловая система
rename
(PHP 4, PHP 5, PHP 7)
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() - Перемещает загруженный файл в новое место
Вернуться к: Файловая система