ftp_rename
(PHP 4, PHP 5, PHP 7)
ftp_rename — Переименовывает файл или директорию на FTP-сервере
Описание
ftp_rename
( resource
$ftp_stream
, string $oldname
, string $newname
) : boolftp_rename() переименовывает файл или директорию на FTP-сервере.
Список параметров
-
ftp_stream
-
Идентификатор соединения с FTP-сервером.
-
oldname
-
Старое имя файла/директории.
-
newname
-
Новое имя.
Возвращаемые значения
Возвращает true
в случае успешного завершения или false
в случае возникновения ошибки. В случае ошибки (например при попытке переименовать несуществующий
файл) будет вызвана ошибка уровня E_WARNING
.
Примеры
Пример #1 Пример использования ftp_rename()
<?php
$old_file = 'somefile.txt.bak';
$new_file = 'somefile.txt';
// установка соединения
$conn_id = ftp_connect($ftp_server);
// проверка имени пользователя и пароля
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);
// попытка переименовать $olf_file в $new_file
if (ftp_rename($conn_id, $old_file, $new_file)) {
echo "Файл $old_file переименован в $new_file\n";
} else {
echo "Не удалось переименовать $old_file в $new_file\n";
}
// закрытие соединения
ftp_close($conn_id);
?>