ftp_rename 函数

适用PHP版本

适用PHP 4.0.0及以上版本

函数说明

ftp_rename() 函数用于重命名 FTP 服务器上的文件或目录。

函数语法

bool ftp_rename ( resource $ftp_stream , string $from , string $to )

参数

• $ftp_stream: 一个有效的 FTP 流（即由 ftp_connect() 或 ftp_ssl_connect() 创建的资源）。
• $from: 要重命名的文件或目录的当前路径（包括文件名）。
• $to: 重命名后的目标路径（包括新的文件名）。

返回值

成功时返回 true，失败时返回 false。

示例

以下是使用 ftp_rename 函数的示例代码：

  // 建立 FTP 连接
  $ftp_conn = ftp_connect("ftp.example.com");

  // 登录到 FTP 服务器
  $login_result = ftp_login($ftp_conn, "username", "password");

  // 检查登录是否成功
  if ((!$ftp_conn) || (!$login_result)) {
      echo "FTP连接失败！";
      exit;
  }

  // 重命名 FTP 服务器上的文件
  $from_file = "oldfile.txt";
  $to_file = "newfile.txt";
  
  if (ftp_rename($ftp_conn, $from_file, $to_file)) {
      echo "文件重命名成功！";
  } else {
      echo "文件重命名失败！";
  }

  // 关闭 FTP 连接
  ftp_close($ftp_conn);
  

示例代码说明

在这个示例中，我们首先使用 ftp_connect 函数连接到 FTP 服务器，并通过 ftp_login 函数进行登录。登录成功后，使用 ftp_rename 函数将文件 oldfile.txt 重命名为 newfile.txt。最后，我们关闭与 FTP 服务器的连接。