函数名称:ftp_rename()
适用版本:PHP 4, PHP 5, PHP 7
函数描述:ftp_rename() 函数用于重命名 FTP 服务器上的文件或目录。
语法:bool ftp_rename ( resource $ftp_stream , string $oldname , string $newname )
参数:
- $ftp_stream:FTP 连接资源标识符,通过 ftp_connect() 函数获取。
- $oldname:需要重命名的文件或目录的旧名称。
- $newname:重命名后的文件或目录的新名称。
返回值:如果重命名成功,则返回 true,否则返回 false。
示例:
// 创建一个 FTP 连接
$conn = ftp_connect('ftp.example.com');
// 登录到 FTP 服务器
$login = ftp_login($conn, 'username', 'password');
// 检查登录是否成功
if (!$conn || !$login) {
die('FTP 连接或登录失败!');
}
// 重命名 FTP 服务器上的文件
$oldname = '/public_html/file.txt';
$newname = '/public_html/newfile.txt';
if (ftp_rename($conn, $oldname, $newname)) {
echo '文件重命名成功!';
} else {
echo '文件重命名失败!';
}
// 关闭 FTP 连接
ftp_close($conn);
在上面的示例中,我们首先创建了一个 FTP 连接,然后使用 ftp_login() 函数登录到 FTP 服务器。接下来,我们使用 ftp_rename() 函数将名为 "file.txt" 的文件重命名为 "newfile.txt"。如果重命名成功,则输出 "文件重命名成功!",否则输出 "文件重命名失败!"。最后,我们使用 ftp_close() 函数关闭 FTP 连接。
请注意,为了使用 ftp_rename() 函数,您需要在 PHP 配置中启用 FTP 扩展。