ftp_rename

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

ftp_rename — Переименовывает файл или директорию на FTP-сервере

Описание

ftp_rename(FTP\Connection $ftp, string $from, string $to): bool

ftp_rename() переименовывает файл или директорию на FTP-сервере.

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

ftp: Экземпляр класса FTP\Connection.
from: Старое имя файла/директории.
to: Новое имя.

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

Функция возвращает true в случае успешного выполнения или false, если возникла ошибка.. Функция выдаст ошибку уровня E_WARNING, если возникнет ошибка (например при попытке переименовать несуществующий файл).

Список изменений

Версия	Описание
8.1.0	Параметр `ftp` теперь ожидает экземпляр класса FTP\Connection; раньше параметр ждал ресурс (resource).

Примеры

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

<?php

$old_file = 'somefile.txt.bak';
$new_file = 'somefile.txt';

// Установка соединения
$ftp = ftp_connect($ftp_server);

// Проверка имени пользователя и пароля
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

// Попытка переименовать $olf_file в $new_file
if (ftp_rename($ftp, $old_file, $new_file)) {
    echo "Файл $old_file успешно переименован в $new_file\n";
} else {
    echo "Не удалось переименовать $old_file в $new_file\n";
}

// Закрытие соединения
ftp_close($ftp);

?>

Улучшение страницы

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 4 notes

down

Hazem dot Khaled at gmail dot com ¶

17 years ago

to rename the file or folder you should use ftp_chdir to select the current directory on ftp server or you should write the full path to file in old name and in new name

Ex. 1
<?php
// open the folder that have the file
ftp_chdir($conn_id, '/www/ftp-filemanager/');

// rename the file
ftp_rename($conn_id, 'file1.jpg', 'new_name_4_file.jpg');
?>

or write full path Ex. 2
<?
// rename the file
ftp_rename($conn_id, '/www/ftp-filemanager/file1.jpg', '/www/ftp-filemanager/new_name_4_file.jpg');
?>

down

Hugo locobyte at hotmail dot NO_SPAM dot com ¶

22 years ago

Using "ftp_rename" to move files to other directories on server ftp
..
...
if(ftp_rename($conn_ftp, $xfiles[$i], "./dirx/".$xfiles[$i])) {
       echo "File $xfiles[$i] moved to ./dirx";
} else {
       echo "ERROR!!!. The file could not be moved";
}
...
..
#-->>h2m,  bye

down

alishahnovin at hotmail dot com ¶

16 years ago

You want to make sure you check the existence of the new name before renaming files, because otherwise you could risk losing files. Just do a simple check with ftp_size with the new name. If it's !=-1, you're going to want to throw some kind of error, otherwise you'll be losing a file...

down

-2

aventaria at hotmxxx dot com ¶

17 years ago

This function isn't only able to rename files, but also folders. And it is not only able to rename them, but also move them, and, in the case of folders, their contents as well (so folders don't have to be empty to move). For example:

<?php
ftp_rename($conn_id, "./dir1/dir2/", "./dir3/");
?>

Now the folder dir2 (which prevously was in folder dir1) has moved to the same folder as dir1, and it has kept its original contents (the content just moved along).

＋Добавить