FTP

說明

ftp 任務實作一個基本 FTP 伺服器，可以傳送、接收、列出、刪除檔案，以及建立目錄。請參閱下方各項任務的說明與範例。

注意：此任務仰賴 Apache Ant 發行版中未包含的外部函式庫。有關更多資訊，請參閱 函式庫相依性。取得此函式庫的最新版本，以獲得 Ant 中最佳的支援。

ftp 任務會嘗試判斷 FTP 伺服器上有哪些檔案系統。支援的伺服器類型有 Unix、NT、OS2、VMS 和 OS400。此外，也正確支援已設定為以 Unix 樣式顯示目錄的 NT 和 OS400 伺服器。否則，系統會預設為 Unix 標準。remotedir 必須以 FTP 伺服器要求的確切語法指定。如果伺服器不支援一般的 Unix 慣例，可以使用 separator 設定應改用哪個檔案分隔符號。

請參閱 目錄基礎任務 一節，了解檔案的包含/排除運作方式，以及如何撰寫模式。

此任務目前不使用 <setproxy> 任務設定的代理資訊，也無法透過 socks 穿透防火牆。

警告：已報告有關 ftp get 搭配 newer 屬性的問題。問題可能是因為 ls -l 的格式與 commons-net 預期的不同，例如由於 FTP 伺服器在目錄清單中使用的語言特定性所致。如果您遇到此類問題，請寄送一封電子郵件，其中包含來自您的 FTP 伺服器（FTP 提示中的 ls -l）的範例目錄清單。

如果您能連線但無法上傳或下載，請嘗試將 passive 屬性設定為 true，以使用現有的（開放的）頻道，而不是讓伺服器嘗試設定新的連線。

參數

關於 remotedir 屬性的注意事項

指定為巢狀元素的參數

fileset

ftp 任務支援任意數量的巢狀 <fileset> 元素，以指定要擷取、刪除、列出或變更模式的檔案。

fileset 的屬性 followsymlinks 支援本機 (put) 和遠端 (get、chmod、delete、list) fileset。在 Ant 1.6 之前，遠端 fileset 不支援符號連結。若要排除符號連結（保留 Ant 1.5.x 及更舊版本的行為），您需要明確將 followsymlinks 設為 false。在遠端 fileset 中，不會檢查隱藏檔案是否為符號連結。目前假設隱藏檔案不是符號連結。

傳送檔案

描述如何傳送檔案最簡單的方法是舉幾個範例。

以 anonymous 身分登入 ftp.apache.org，並將 htdocs/manual 目錄中的所有檔案上傳到該使用者的預設目錄。

<ftp server="ftp.apache.org"
     userid="anonymous"
     password="me@myorg.com">
    <fileset dir="htdocs/manual"/>
</ftp>

以 anonymous 身分登入 ftp.apache.org，並將 htdocs/manual 目錄中所有新增或變更的檔案上傳到 anonymous 的預設目錄相對應的 incoming 目錄。

<ftp server="ftp.apache.org"
     remotedir="incoming"
     userid="anonymous"
     password="me@myorg.com"
     depends="yes">
    <fileset dir="htdocs/manual"/>
</ftp>

以 coder 身分使用密碼 java1 登入埠 2121 上的 ftp.apache.org，並將 htdocs/manual 目錄中所有新增或變更的 HTML 檔案上傳到 /pub/incoming 目錄。檔案以文字模式傳輸。已開啟被動模式，以便在防火牆後傳送檔案。

<ftp server="ftp.apache.org"
     port="2121"
     remotedir="/pub/incoming"
     userid="coder"
     password="java1"
     passive="yes"
     depends="yes"
     binary="no">
    <fileset dir="htdocs/manual">
        <include name="**/*.html"/>
    </fileset>
</ftp>

以 coder 身分使用密碼 java1 登入埠 2121 上的 Windows 伺服器 ftp.hypothetical.india.org，並將 htdocs/manual 目錄中所有新增或變更（考量時區差異）的 HTML 檔案上傳到 /pub/incoming 目錄。檔案以文字模式傳輸。

<ftp server="ftp.hypothetical.india.org"
     port="2121"
     remotedir="/pub/incoming"
     userid="coder"
     password="java1"
     depends="yes"
     binary="no"
     systemTypeKey="Windows"
     serverTimeZoneConfig="India/Calcutta">
    <fileset dir="htdocs/manual">
        <include name="**/*.html"/>
    </fileset>
</ftp>

以 coder 使用密碼 java1 登入 Windows-based ftp.nt.org，並將 htdocs/manual 目錄中的所有 HTML 檔案上傳至 c:\uploads 目錄。上傳每個檔案時，進度訊息會顯示。

<ftp server="ftp.nt.org"
     remotedir="c:\uploads"
     userid="coder"
     password="java1"
     separator="\"
     verbose="yes">
    <fileset dir="htdocs/manual">
        <include name="**/*.html"/>
    </fileset>
</ftp>

取得檔案

從 FTP 伺服器取得檔案的方式與傳送檔案的方式大致相同。唯一的差異在於，巢狀檔案集使用 remotedir 屬性作為 FTP 伺服器上檔案的基礎目錄，並使用 dir 屬性作為將檔案放入的本機目錄。FTP 網站的檔案結構會保留在本地端機器上。

以 anonymous 登入 ftp.apache.org，並遞迴下載該使用者預設目錄中的所有 .html 檔案至本地端機器上的 htdocs/manual 目錄。

<ftp action="get"
     server="ftp.apache.org"
     userid="anonymous"
     password="me@myorg.com">
    <fileset dir="htdocs/manual">
        <include name="**/*.html"/>
    </fileset>
</ftp>

如果 apache.org 曾經切換至使用新全數字格式時間戳記的 Unix FTP 伺服器，則此版本將變得必要。它將完成與前一個範例相同的功能，但會成功處理數字時間戳記。systemTypeKey 在這裡並非必要，但有助於釐清發生了什麼事。

<ftp action="get"
     server="ftp.apache.org"
     userid="anonymous"
     password="me@myorg.com"
     systemTypeKey="UNIX"
     defaultDateFormatConfig="yyyy-MM-dd HH:mm">
    <fileset dir="htdocs/manual">
        <include name="**/*.html"/>
    </fileset>
</ftp>

以 anonymous 登入顯示日期為標準歐洲格式的法文名稱的 UNIX FTP 伺服器 ftp.hypothetical.fr，並遞迴下載該使用者預設目錄中的所有 .html 檔案至本地端機器上的 htdocs/manual 目錄。

<ftp action="get"
     server="ftp.hypthetical.fr"
     userid="anonymous"
     password="me@myorg.com"
     defaultDateFormatConfig="d MMM yyyy"
     recentDateFormatConfig="d MMM HH:mm"
     serverLanguageCodeConfig="fr">
    <fileset dir="htdocs/manual">
        <include name="**/*.html"/>
    </fileset>
</ftp>

刪除檔案

您現在可能已經猜到了，您使用巢狀檔案集元素來選取要從遠端 FTP 伺服器刪除的檔案。同樣地，檔案集是相對於遠端目錄，而不是本機目錄。事實上，檔案集的 dir 屬性會被完全忽略。

以 anonymous 登入 ftp.apache.org，並嘗試從該使用者的預設目錄中刪除所有 *.tmp 檔案。如果您沒有刪除檔案的權限，則會擲回 BuildException。

<ftp action="del"
     server="ftp.apache.org"
     userid="anonymous"
     password="me@myorg.com">
    <fileset>
        <include name="**/*.tmp"/>
    </fileset>
</ftp>

列出檔案

取得 anonymous 使用者的預設目錄中所有 FTP 伺服器檔案的檔案清單，並儲存在 data/ftp.listing 中。清單格式為 FTP 伺服器通常列出檔案的格式。

<ftp action="list"
     server="ftp.apache.org"
     userid="anonymous"
     password="me@myorg.com"
     listing="data/ftp.listing">
    <fileset>
        <include name="**"/>
    </fileset>
</ftp>

建立目錄

請注意，對於 mkdir 動作，要建立的目錄是使用 remotedir 屬性指定的。

在預設根目錄下建立目錄 some/remote/dir。與所有其他動作一樣，目錄分隔字元必須根據 FTP 伺服器的需求正確。

<ftp action="mkdir"
     server="ftp.apache.org"
     userid="anonymous"
     password="me@myorg.com"
     remotedir="some/remote/dir"/>

移除目錄

此動作使用巢狀 fileset 元素來選取要從遠端 FTP 伺服器移除的目錄。fileset 是相對於遠端目錄，而不是本機目錄。dir fileset 的屬性會被完全忽略。要移除的目錄必須是空的，或只包含其他也已選取要由 fileset 模式移除的目錄，否則會擲回 BuildException。此外，如果您沒有權限移除目錄，也會擲回 BuildException。

以 anonymous 身分登入 ftp.apache.org，並嘗試移除 /somedir/dira 目錄和從 /somedir/dirb 開始（包含）的所有目錄樹。在移除 /somedir/dirb 樹時，此工作會從樹葉開始移至根目錄，如此一來，當它嘗試移除目錄時，可以確定其下的所有目錄都已移除。顯然樹中的所有檔案都必須已刪除。

<ftp action="rmdir"
     server="ftp.apache.org"
     userid="anonymous"
     password="me@myorg.com"
     remotedir="/somedir" >
    <fileset>
        <include name="dira"/>
        <include name="dirb/**"/>
    </fileset>
</ftp>

舉例來說，假設您想要刪除 /somedir 中包含的所有內容，因此先呼叫 action=delete 的 <ftp> 工作，然後呼叫 action=rmdir，並在兩種情況下指定 remotedir=/somedir 和

<fileset>
    <include name="**"/>
</fileset>

在 remotedir 參數中指定的目錄永遠不會選取為移除，因此如果您需要移除它，請在 remotedir 參數中指定其父目錄，並將其包含在 <fileset> 模式中，例如 somedir/**。