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 实例;以前,需要一个 资源

示例

示例 #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);

// 尝试将 $old_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 个注释

Hugo locobyte at hotmail dot NO_SPAM dot com
21 年前
使用 "ftp_rename" 将文件移动到服务器 ftp 上的其他目录
..
...
if(ftp_rename($conn_ftp, $xfiles[$i], "./dirx/".$xfiles[$i])) {
echo "文件 $xfiles[$i] 已移动到 ./dirx";
} else {
echo "ERROR!!!. 文件无法移动";
}
...
..
#-->>h2m, 再见
alishahnovin at hotmail dot com
16 年前
您需要在重命名文件之前确保检查新名称是否存在,因为否则您可能会丢失文件。 只需使用新名称对 ftp_size 进行简单的检查。 如果它 !=-1,则您需要抛出某种错误,否则您将丢失文件...
Hazem dot Khaled at gmail dot com
17 年前
要重命名文件或文件夹,您应该使用 ftp_chdir 选择 FTP 服务器上的当前目录,或者您应该在旧名称和新名称中写入文件的完整路径

示例 1
<?php
// 打开包含文件的文件夹
ftp_chdir($conn_id, '/www/ftp-filemanager/');

// 重命名文件
ftp_rename($conn_id, 'file1.jpg', 'new_name_4_file.jpg');
?>

或写入完整路径 示例 2
<?
// 重命名文件
ftp_rename($conn_id, '/www/ftp-filemanager/file1.jpg', '/www/ftp-filemanager/new_name_4_file.jpg');
?>
aventaria at hotmxxx dot com
17 年前
此函数不仅可以重命名文件,还可以重命名文件夹。 它不仅可以重命名它们,还可以移动它们,并且在文件夹的情况下,还可以移动它们的内容(因此文件夹不必为空才能移动)。 例如

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

现在文件夹 dir2(以前在文件夹 dir1 中)已移动到与 dir1 相同的文件夹,并且它保留了其原始内容(内容只是移动了)。
To Top