FTP - File Transfer Protocol

Posted 2020-10-19 zzYzz

 1 FTP - File Transfer Protocol
 2     FTP 实际上使用了两个 TCP 链接. 一个作为控制信道用, 主要传输一些指令和响应,
 3     比如 ACK 或 错误码. 另一个链接是数据信道, 用来传输文件和一些诸如目录列表的
 4     信息等.
 5 
 6     from ftplib import FTP, all_errors
 7     FtpServerAddr = ‘‘
 8     user = ‘‘
 9     PW = ‘‘
10     acct = ‘‘
11 
12     FH = FTP(FtpServerAddr)
13     FH.login(user, PW, acct) # 不带参数表示 anonymous 登入
14 
15     FH.getwelcome()  # 获取问候语
16     FH.pwd()         # 获取当前工作目录
17     FH.cwd()         # 更换工作目录
18     FH.retrlines(‘cmd‘, ‘callable‘)    # 以 ASCII 模式下载, 文件被一行一行的传输.
19                                        # 一般 callable 是一个保存文件到本地的函数,
20                                        # 省略 callable, 数据将被打印到屏幕.
21                                        # cmd = ‘RETR filename‘
22     FH.retrbinary(‘cmd‘, ‘callable‘, ‘blocksize‘, ‘rest‘)
23                                        # 以二进制模式下载数据
24         # If optional rest is given, a REST command is sent to the server,
25         # passing rest as an argument. rest is usually a byte offset into
26         # the requested file, telling the server to restart sending the file’s
27         # bytes at the requested offset, skipping over the initial bytes.
28         # Note however that RFC 959 requires only that rest be a string containing
29         # characters in the printable range from ASCII code 33 to ASCII code 126.
30         # The method, therefore, converts rest to a string, but no check is performed
31         # on the string’s contents. If the server does not recognize the REST command,
32         # an error_reply exception will be raised. If this happens, simply call method
33         # without a rest argument.
34 
35     FH.storbinary(‘cmd‘, ‘FH‘, ‘blocksize‘, ‘callable‘, ‘rest‘)
36                                        # 对应 socket 的 read() 方法, 二进制模式.
37                                        # cmd = ‘STOR filename‘
38     FH.storlines(‘cmd‘, ‘FH‘, ‘callable‘)
39                                        # 对应 socket 的 readline() 方法, ACSII 模式.
40                                        # cmd = ‘STOR filename‘
41     FH.nlst()                          # 获取路径下的条目
42     FH.dir()                           # 获取路径下的条目及相信信息, ls - la / dir
43 
44     FH.delete(‘filename‘)              # 删除 filename 文件
45     FH.rmd(‘dirname‘)                  # 删除 dirname 目录
46     FH.mkd(‘dirname‘)                  # 建立 dirname 目录
47     FH.rename(‘fromname‘, ‘toname‘)    # 重命名
48     FH.quit()        # 断开 FTP 链接
49 
50 Error Handling,
51     ftplib.all_errors 包含累所有的有可能由 fitplib 产生的异常.
52     可以在 try: except 代码块中通过 ftplib.all_errors 来捕捉
53     处理可能发生的错误.
54 
55 Reference,
56     Python doc,
57         https://docs.python.org/3/library/ftplib.html