总览
本文将展示在Python中如何在ftplib模块的帮助下使用FTP。
Ftplib
Python中的ftplib模块允许您编写执行各种自动FTP作业的Python程序。您可以轻松地连接到FTP服务器以检索文件并在本地处理它们。要在Python中使用ftplib模块,首先必须将其导入脚本。
打开连接
要”open”与FTP服务器的连接,您必须创建对象。建立连接(打开)后,就可以使用ftplib模块中的方法了。有两种方法可以使用:一种用于处理文本文件,另一种用于二进制文件。您可以轻松查看目录结构,管理和下载文件。
如何使用?
该程序将首先连接到FTP服务器(ftp.cwi.nl),然后使用 LIST()方法列出FTP服务器根目录中的文件和目录。
from ftplib import FTP
ftp = FTP('ftp.cwi.nl') # 连接到服务器, 使用默认端口:21
ftp.login() # user: anonymous, passwd anonymous@
ftp.retrlines('LIST') # list directory contents
我们的第二个程序以电子邮件用户’anonymous@sunet.se’的用户身份’anonymous'(匿名)打开到’ftp.sunet.se’的连接,然后使用 dir()方法列出FTP服务器上的文件和目录。输出将保存到’files’变量。
然后,我使用打印在屏幕上查看文件。如果我想更改目录,则只需使用ftp.cwd(path)即可。要关闭FTP连接,请使用 quit()方法。
import ftplib
ftp = ftplib.FTP('ftp.sunet.se', 'anonymous', 'anonymous@sunet.se')
print "File List: "
files = ftp.dir()
print files
ftp.cwd("/pub/unix") #changing to /pub/unix
常见的FTP方法
FTP.connect(主机[,端口[,超时]])
连接到给定的主机和端口。默认端口号是21,由FTP协议规范指定。很少需要指定其他端口号。对于每个实例仅应调用一次此函数,如果在创建实例时给出了主机,则根本不应调用此函数。所有其他方法只能在这个连接已取得后使用
。可选的timeout参数指定连接尝试的超时时间(以秒为单位)。如果没有超时,则使用全局默认超时设置。
FTP.getwelcome()
返回服务器发送的欢迎消息以回复初始连接。该消息有时包含与用户可能相关的免责声明或帮助信息
FTP.login([用户[,passwd [,acct]]])
以给定用户身份登录。 passwd和acct参数是可选的,默认为空字符串。如果未指定用户,则默认为’anonymous’。
如果用户为’anonymous’,则默认密码为’anonymous@’。
建立连接后,对于每个实例仅应调用一次此函数。如果在实例时给出了主机和用户已创建,则根本不应调用它。
只有在客户端登录后,才允许大多数FTP命令。acct参数提供“accounting information”;很少有系统实现这一点。
FTP.retrbinary(command,callback [,maxblocksize [,rest]])
以二进制传输模式检索文件。命令应该是适当的RETR命令:’RETR filename’。对于每个接收到的数据块,将调用回调函数,并使用单个字符串参数指定该数据块。
可选的maxblocksize参数指定在为执行实际传输而创建的底层套接字对象上读取的最大块大小。
选择一个合理的默认值。其余与 transfercmd()方法中的含义相同。
FTP.retrlines(command [,callback])
以ASCII传输模式检索文件或目录列表。命令应为适当的RETR命令或LIST,NLST或MLSD之类的命令。
LIST检索文件列表以及有关这些文件的信息。
NLST检索文件名列表。
在某些服务器上,MLSD检索机器可读的文件列表以及有关这些文件的信息。每一行都使用一个字符串参数调用回调函数,该参数包含删除了尾随CRLF的行。默认回调将行打印到sys.stdout。
FTP.dir(参数[,…])
生成目录列表(类似LIST命令),将其打印到标准输出中。可选参数是要列出的目录(默认为当前服务器目录)。可以使用多个参数将非标准选项传递给LIST命令。如果最后一个参数是一个函数,则将其用作与 retrlines()相同的回调函数。默认打印到sys.stdout。此方法返回无。
FTP.delete(filename)
从服务器中删除名为filename的文件。如果成功,则返回响应的文本,否则在权限错误时引发error_perm,在其他错误时引发error_reply。
FTP.cwd(pathname)
pathname是路径名,在服务器上跳转到当前目录。
FTP.mkd(pathname)
pathname是路径名,在服务器上创建一个新目录。
FTP.pwd()
返回服务器上当前目录的路径名。
FTP.quit()
将QUIT命令发送到服务器并关闭连接。这是比FTP.close()更“polite”(礼貌)关闭连接的方法,但是如果服务器对QUIT命令返回错误,则可能会引发异常。这意味着将调用 close()方法,该方法使FTP实例对于后续调用无效。
FTP.close()
单方面关闭连接。这不应应用于已经关闭的连接,例如在成功调用 quit()之后。在此调用之后,不应再使用FTP实例。调用 close()或 quit()之后,您将无法通过发出另一个 login()方法来重新打开连接。
有关更多信息,请参见官方Python文档