Python ftplib模块

Python ftplib模块

官方文档：https://docs.python.org/3/library/ftplib.html?highlight=ftplib#module-ftplib

实例：https://www.example-code.com/python/ftp.asp

ftp登陆连接
from ftplib import FTP            #加载ftp模块
ftp=FTP()                         #设置变量
ftp.set_debuglevel(2)             #打开调试级别2，显示详细信息
ftp.connect("IP","port")          #连接的ftp sever和端口
ftp.login("user","password")      #连接的用户名，密码
print ftp.getwelcome()            #打印出欢迎信息
ftp.abort ()        #中止正在进行的文件传输。使用这种方法并不总是有效，但是值得一试。
ftp.sendcmd (cmd)        #向服务器发送一个简单的命令字符串并返回响应字符串。
ftp.voidcmd(cmd)        #向服务器发送一个简单的命令字符串并处理响应。如果接收到与成功对应的响应代码(范围为200-299)，则不返回任何内容。提高error_reply否则。
ftp.retrbinary(cmd, callback, blocksize=8192, rest=None)   #以二进制传输模式检索文件。cmd应该是一个适当的RETR命令:'RETR filename'。对于接收到的每个数据块调用回调函数，并使用一个字节参数给出数据块。可选块大小参数指定要读取的底层套接字对象的最大块大小，该套接字对象是为执行实际传输而创建的(这也是传递给回调的数据块的最大大小)。选择一个合理的默认值。rest与transfercmd()方法中的含义相同。
ftp.retrlines (cmd,callback=)        #检索ASCII传输模式下的文件或目录列表。cmd应该是一个适当的RETR命令(请参阅retrbinary())或一个类似LIST或NLST的命令(通常只是字符串“LIST”)。LIST检索文件列表和有关这些文件的信息。NLST检索文件名列表。为每一行调用回调函数，其中包含一个字符串参数，该参数包含删除了尾随CRLF的行。默认回调函数将该行打印到sys.stdout。
ftp.set_pasv (val)        #如果val为真，则启用“被动”模式，否则禁用被动模式。默认情况下处于被动模式。
ftp.storbinary(cmd, fp, blocksize=8192, callback=None, rest=None)  #以二进制传输模式存储文件。cmd应该是一个适当的STOR命令:“STOR filename”。fp是一个文件对象(以二进制模式打开)，直到EOF使用其read()方法以块大小块大小的方式提供要存储的数据为止。块大小参数默认为8192。回调是一个可选的单参数可调用，它在发送数据块之后对每个数据块调用。rest与transfercmd()方法中的含义相同。
ftp.cmd("xxx/xxx")                #进入远程目录
file_handle=open(filename,"wb").write #以写模式在本地打开文件
ftp.retrbinaly("RETR filename.txt",file_handle,bufsize) #接收服务器上文件并写入本地文件
ftp.set_debuglevel(0)             #关闭调试模式

ftp相关命令操作
ftp.cwd(pathname)                 #设置FTP当前操作的路径
ftp.dir()                         #显示目录下所有目录信息
ftp.nlst()                        #获取目录下的文件
ftp.mkd(pathname)                 #新建远程目录
ftp.pwd()                         #返回当前所在位置
ftp.rmd(dirname)                  #删除远程目录
ftp.delete(filename)              #删除远程文件
ftp.size(文件名)        #请求服务器上名为filename的文件的大小。成功时，文件大小作为整数返回，否则不返回任何值。注意，SIZE命令不是标准化的，但是许多常见的服务器实现都支持它。
ftp.rename(fromname, toname)#将fromname修改名称为toname。
ftp.storbinaly("STOR filename.txt",file_handel,bufsize)  #上传目标文件
ftp.retrbinary("RETR filename.txt",file_handel,bufsize)  #下载FTP文件
ftp.quit ()            #向服务器发送退出命令并关闭连接。这是关闭连接的“礼貌”方式，但如果服务器对QUIT命令响应错误，则可能引发异常。这意味着对close()方法的调用将使FTP实例对后续调用无效(参见下面)。
ftp.close ()          #单方面关闭连接。这不应该应用于已经关闭的连接，例如成功调用quit()之后。然后调用FTP实例
ftp.storlines (cmd, fp, callback=None)  #以ASCII传输模式存储文件。cmd应该是一个适当的STOR命令(参见storbinary())。使用readline()方法从文件对象fp(以二进制模式打开)中读取行，直到EOF，以提供要存储的数据。回调是一个可选的单参数可调用，它在发送后的每一行上调用。
ftp.transfercmd (cmd,rest=None)  #通过数据连接启动传输。如果传输活动，发送EPRT或PORT命令和cmd指定的传输命令，并接受连接。如果服务器是被动的，发送一个EPSV或PASV命令，连接到它，并启动传输命令。无论哪种方式，返回连接的套接字。如果提供了可选rest，则向服务器发送一个rest命令，并将rest作为参数传递。rest通常是请求文件中的字节偏移量，它告诉服务器在请求偏移量处重新发送文件的字节，跳过初始字节。但是请注意，RFC 959只要求rest是一个字符串，包含ASCII码33到ASCII码126之间可打印范围内的字符。因此，transfercmd()方法将rest转换为字符串，但是不检查字符串的内容。如果服务器不识别REST命令，将引发error_reply异常。如果发生这种情况，只需调用transfercmd()而不使用rest参数。
ftp.ntransfercmd (cmd,rest=None) #与transfercmd()类似，但是返回数据连接的元组和数据的期望大小。如果无法计算预期大小，则不会返回任何作为预期大小的值。cmd和rest与transfercmd()中的含义相同。
ftp.mlsd(路径= " ", facts= [])   #使用MLSD命令(RFC 3659)以标准格式列出目录。如果省略path，则假定当前目录。facts是表示所需信息类型的字符串列表(例如["type"、"size"、"perm"])。返回生成器对象，该对象为path中找到的每个文件生成一个由两个元素组成的元组。第一个元素是文件名，第二个元素是包含文件名事实的字典。此字典的内容可能受到事实参数的限制，但服务器不能保证返回所有请求的事实。

FTP.quit()与FTP.close()的区别
FTP.quit():发送QUIT命令给服务器并关闭掉连接。这是一个比较“缓和”的关闭连接方式，但是如果服务器对QUIT命令返回错误时，会抛出异常。
FTP.close()：单方面的关闭掉连接，不应该用在已经关闭的连接之后，例如不应用在FTP.quit()之后。

异常ftplib.error_reply  #当从服务器接收到意外响应时引发异常。

异常ftplib.error_temp  #当接收到表示临时错误的错误代码(范围为400-499的响应代码)时引发异常。

异常ftplib.error_perm  #当接收到表示永久错误的错误代码(范围为500-599的响应代码)时引发异常。

异常ftplib.error_proto  #当从服务器接收到不符合文件传输协议的响应规范(即以数字开头)的响应时，会引发异常

ftplib.all_errors     #FTP实例的方法可能由于FTP连接问题(与调用方所犯的编程错误相反)而引发的所有异常的集合(作为一个元组)。这个集合包括上面列出的四个异常以及OSError。

FTP_TLS对象  #FTP_TLS类继承自FTP，定义这些附加对象:

FTP_TLS.ssl_version  #要使用的SSL版本(默认为SSL . protocol_sslv23)。

FTP_TLS.auth ()    #根据ssl_version属性中指定的内容，使用TLS或SSL设置安全控制连接。

#在3.4版中更改:该方法现在支持使用ssl.SSLContext检查主机名。check_hostname和服务器名指示(参见ssl.HAS_SNI)。

FTP_TLS.ccc ()  #将控制通道还原为纯文本。这对于利用防火墙非常有用，因为防火墙知道如何在不打开固定端口的情况下使用不安全的FTP处理NAT。

FTP_TLS.prot_p ()  #建立安全的数据连接。

FTP_TLS.prot_c ()    #设置明文数据连接。

(Python) FTP中的主动和被动模式

被动属性控制上传/下载的数据连接是在主动模式还是被动模式下建立的。若要使用主动模式，请设置被动属性 Passive property= False。这是默认值。若要使用被动模式，请设置被动属性  Passive property= True。

被动模式/主动模式:

主动模式:
FTP客户机选择一个端口号并向FTP服务器发送一个“port”命令。然后FTP客户机在选择的端口侦听，FTP服务器发出连接请求来建立连接。数据连接从FTP服务器发出，并传入FTP客户机。

被动模式:
FTP客户机向FTP服务器发送一个PASV命令。FTP服务器选择一个端口号并在PASV响应中发送它。然后FTP服务器在该端口侦听来自FTP客户机的传入连接请求。数据连接传入FTP服务器，并从FTP客户机发出。

Python模块适用于Windows, Linux, Alpine Linux，
MAC OS X, Solaris, FreeBSD, OpenBSD，

import sys
import chilkat

ftp = chilkat.CkFtp2 ()

#任何字符串在前30天内解锁组件。
success = ftp.UnlockComponent(“Anything for 30-day trial”)
if (success != True):
print (ftp.lastErrorText ())
sys.exit ()

ftp.put_Hostname (“ftp.something.com”)
ftp.put_Username(“测试”)
ftp.put_Password(“测试”)

#连接并登录到FTP服务器。
succes= ftp.Connect ()
if (success != True):
print (ftp.lastErrorText ())
sys.exit ()

#使用被动模式:
ftp.put_Passive(True)

#使用主动模式:
ftp.put_Passive(False)

下载、上传文件

#coding: utf-8
from ftplib import FTP
import time
import tarfile
#!/usr/bin/python
#-*- coding: utf-8 -*-

from ftplib import FTP

def ftpconnect(host, username, password):
    ftp = FTP()
    #ftp.set_debuglevel(2)         #打开调试级别2，显示详细信息
    ftp.connect(host, 21)          #连接
    ftp.login(username, password)  #登录，如果匿名登录则用空串代替即可
    return ftp

def downloadfile(ftp, remotepath, localpath):
    bufsize = 1024                #设置缓冲块大小
    fp = open(localpath,'wb')     #以写模式在本地打开文件
    ftp.retrbinary('RETR ' + remotepath, fp.write, bufsize) #接收服务器上文件并写入本地文件
    ftp.set_debuglevel(0)         #关闭调试
    fp.close()                    #关闭文件

def uploadfile(ftp, remotepath, localpath):
    bufsize = 1024
    fp = open(localpath, 'rb')
    ftp.storbinary('STOR '+ remotepath , fp, bufsize) #上传文件
    ftp.set_debuglevel(0)
    fp.close()                                    

if __name__ == "__main__":
    ftp = ftpconnect("******", "***", "***")
    downloadfile(ftp, "***", "***")
    uploadfile(ftp, "***", "***")

    ftp.quit()

上传、下载文件/目录

#coding:utf-8
from ctypes import *
import os
import sys
import ftplib

class myFtp:
    ftp = ftplib.FTP()
    bIsDir = False
    path = ""
    def __init__(self, host, port=''):
        #self.ftp.set_debuglevel(2) #打开调试级别2，显示详细信息
        #self.ftp.set_pasv(0)      #0主动模式 1 #被动模式
        self.ftp.connect( host, port )

    def Login(self, user, passwd):
        self.ftp.login( user, passwd )
        print self.ftp.welcome

    def DownLoadFile(self, LocalFile, RemoteFile):
        file_handler = open( LocalFile, 'wb' )
        self.ftp.retrbinary( "RETR %s" %( RemoteFile ), file_handler.write )
        file_handler.close()
        return True

    def UpLoadFile(self, LocalFile, RemoteFile):
        if os.path.isfile( LocalFile ) == False:
            return False
        file_handler = open(LocalFile, "rb")
        self.ftp.storbinary('STOR %s'%RemoteFile, file_handler, 4096)
        file_handler.close()
        return True

    def UpLoadFileTree(self, LocalDir, RemoteDir):
        if os.path.isdir(LocalDir) == False:
            return False
        print "LocalDir:", LocalDir
        LocalNames = os.listdir(LocalDir)
        print "list:", LocalNames
        print RemoteDir
        self.ftp.cwd( RemoteDir )
        for Local in LocalNames:
            src = os.path.join( LocalDir, Local)
            if os.path.isdir( src ): self.UpLoadFileTree( src, Local )
            else:
                self.UpLoadFile( src, Local )

        self.ftp.cwd( ".." )
        return

    def DownLoadFileTree(self, LocalDir, RemoteDir):
        print "remoteDir:", RemoteDir
        if os.path.isdir( LocalDir ) == False:
            os.makedirs( LocalDir )
        self.ftp.cwd( RemoteDir )
        RemoteNames = self.ftp.nlst()
        print "RemoteNames", RemoteNames
        print self.ftp.nlst("/del1")
        for file in RemoteNames:
            Local = os.path.join( LocalDir, file )
            if self.isDir( file ):
                self.DownLoadFileTree( Local, file )
            else:
                self.DownLoadFile( Local, file )
        self.ftp.cwd( ".." )
        return

    def show(self, list):
        result = list.lower().split( " " )
        if self.path in result and "<dir>" in result:
            self.bIsDir = True

    def isDir(self, path):
        self.bIsDir = False
        self.path = path
        #this ues callback function ,that will change bIsDir value
        self.ftp.retrlines( 'LIST', self.show )
        return self.bIsDir

    def close(self):
        self.ftp.quit()

if __name__ == "__main__":
    ftp = myFtp('*****')
    ftp.Login('***','***')

    ftp.DownLoadFileTree('del', '/del1')#ok
    ftp.UpLoadFileTree('del', "/del1" )
    ftp.close()
    print "ok!"

注：目录内为文件，若为目录则无法传输

异常处理

#coding: utf-8
#from ftplib import FTP
import ftplib
import socket
import os

def ftpconnect(ftp_info):
    try:
        ftp = ftplib.FTP(ftp_info[0])
    except (socket.error, socket.gaierror):
        print "ERROR: cannot reach %s" % ftp_info[0]
        return None

    username = ftp_info[1]
    passwd = ftp_info[2]
    try:
        ftp.login(username, passwd)
    except ftplib.error_perm:
        print "ERROR: cannot login anonymously"
        ftp.quit()
        return None
    return ftp

if __name__ == "__main__":
    info_list = ["10.19.3.199", "fastupdate_amap", "@utonavi&A.map"]
    ftp = ftpconnect(info_list)
    if not ftp:
        exit(1)
    bufsize = 1024
    fname = "20150416113942674.tar.gz"
    fp = open(os.path.join(".", fname), 'wb')
    remotefile = os.path.join("/ADF++", fname)
    ftp.retrbinary("RETR " + remotefile, fp.write, bufsize)

    #是否有目录，没有就创建；有的话看是否有权限创建
    a = ftp.dir()
    try:
        ftp.cwd("jimi")
    except ftplib.error_perm:
        try:
            ftp.mkd("jimi")
        except ftplib.error_perm:
            print "WARNING: U have no authority to make dir"
    finally:
        ftp.quit()