函数名称:ftp_put()
函数描述:ftp_put() 函数用于将本地文件上传到远程 FTP 服务器。
适用版本:PHP 4, PHP 5, PHP 7
语法:bool ftp_put ( resource $ftp_stream, string $remote_file, string $local_file, int $mode [, int $startpos = 0 ] )
参数说明:
- $ftp_stream:一个有效的 FTP 连接资源。
- $remote_file:远程服务器上保存上传文件的路径和文件名。
- $local_file:本地文件的路径和文件名。
- $mode:传输模式,可以是 FTP_ASCII(文本模式)或 FTP_BINARY(二进制模式)。
- $startpos:可选参数,用于设置远程文件的起始位置。
返回值:
- 如果上传成功,则返回 true,否则返回 false。
示例代码:
// 建立 FTP 连接 $ftp_conn = ftp_connect("ftp.example.com");
// 登录 FTP 服务器 $login = ftp_login($ftp_conn, "username", "password");
// 检查是否成功连接和登录 if (!$ftp_conn || !$login) { echo "FTP 连接或登录失败"; exit; }
// 上传本地文件到远程服务器 $remote_file = "/path/to/remote/file.txt"; $local_file = "/path/to/local/file.txt"; $mode = FTP_BINARY;
if (ftp_put($ftp_conn, $remote_file, $local_file, $mode)) { echo "文件上传成功"; } else { echo "文件上传失败"; }
// 关闭 FTP 连接 ftp_close($ftp_conn);
说明:
- 首先,使用 ftp_connect() 函数建立与远程 FTP 服务器的连接。
- 然后,使用 ftp_login() 函数登录到 FTP 服务器。
- 接下来,使用 ftp_put() 函数将本地文件上传到远程服务器。在示例中,我们指定了远程文件路径、本地文件路径和传输模式。
- 最后,使用 ftp_close() 函数关闭 FTP 连接。
注意事项:
- 在使用 ftp_put() 函数之前,需要先建立 FTP 连接并登录到 FTP 服务器。
- 上传文件时,需要确保远程服务器上的目录和文件具有适当的写权限。
- 传输模式可以是 FTP_ASCII(文本模式)或 FTP_BINARY(二进制模式),根据上传文件的类型选择合适的模式。
- 如果需要续传文件,可以使用 $startpos 参数来指定远程文件的起始位置。