雖然 REST API 已成為主流,但在企業內部系統、機上盒韌體更新、早有既有伺服器的專案裡,FTP 依然常見。Swift 要寫 FTP 客戶端,最省事的方式是借用成熟套件——這裡用 Rebekka。
Rebekka 是一套用 Swift 撰寫的 FTP/FTPS 客戶端函式庫,底層封裝了 CFNetworking 的 CFFTPStream API。下載網址:https://github.com/Constantine-Fry/rebekka
(1)把 Rebekka.xcodeproj 拖進你的專案。

(2)到「專案」→「Build Phases」→「Target Dependencies」把 RebekkaTouch 加進來。

(3)使用處 import 即可:
import RebekkaTouch
把主機、帳號、密碼打包成 SessionConfiguration,再交給 Session,之後所有操作都透過這個 session 進行:
import UIKit
import RebekkaTouch
class ViewController: UIViewController {
var session: Session!
override func viewDidLoad() {
super.viewDidLoad()
var configuration = SessionConfiguration()
configuration.host = "ftp://ftp.hangge.com"
configuration.username = "ftpuser"
configuration.password = "123456"
session = Session(configuration: configuration)
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
}
把根目錄下的項目逐一印出。除了名稱與型別,Rebekka 也能取得建立者、建立時間等資訊:
showList("/")
func showList(path: String) {
session.list(path) {
(resources, error) -> Void in
for item in resources! {
print("文件類型:\(item.type) 文件名稱:\(item.name)")
}
}
}

createDirectory("/upload/測試文件夾")
func createDirectory(path: String) {
session.createDirectory(path) {
(result, error) -> Void in
if result {
print("文件夾創建成功!")
} else {
print("文件夾創建失敗: \(error)")
}
}
}
伺服器端路徑可以用 UUID 產生,避免同名覆蓋:
func testUploadFile() {
// 本機檔案
let URL = NSBundle.mainBundle().URLForResource("logo", withExtension: "png")
// 伺服器路徑與存檔名稱
let path = "/upload/\(NSUUID().UUIDString).png"
session.upload(URL!, path: path) {
(result, error) -> Void in
if result {
print("文件上傳成功!")
} else {
print("文件上傳失敗: \(error)")
}
}
}
Rebekka 下載的檔案預設放在暫存目錄並以隨機名稱命名,因此在下載完成的回呼裡,通常要自己搬到正式目錄並重新命名,否則系統清理暫存區時檔案就消失了。
func testDownloadFile() {
self.session.download("/upload/hangge.png") {
(fileURL, error) -> Void in
print("文件保存地址:\(fileURL)")
// 下載回來的是暫存檔,需要自行處理(搬移或刪除)
// if let fileURL = fileURL {
// do {
// try NSFileManager.defaultManager().removeItemAtURL(fileURL)
// } catch let error as NSError {
// print("Error: \(error)")
// }
// }
}
}
坦白說,除非要對接既有伺服器,否則不建議。FTP 預設不加密,帳密以明文傳輸,即使改用 FTPS,設定也遠比 HTTPS 麻煩。另外 Rebekka 這個套件已多年未更新,在新版 Swift 上需要自行調整才能編譯。若只是要傳檔案,用 URLSession 搭配 HTTP PUT/POST,或整合 AWS S3 這類物件儲存服務,都會是更省心的選擇。