array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.rename.php', 1 => 'rename', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Функции файловой системы', ), 'prev' => array ( 0 => 'function.realpath.php', 1 => 'realpath', ), 'next' => array ( 0 => 'function.rewind.php', 1 => 'rewind', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/filesystem/functions/rename.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
rename — Переименовывает файл или директорию
Пытается переименовать 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");
?>