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='21'):
        #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()