上一篇談完了資料請求,這篇把焦點轉到上傳。Alamofire 把上傳這件事抽象得很漂亮,無論你手上是一個檔案、一段 Data、串流,還是要模擬網頁表單的多檔送出,都有對應的方法。
File(檔案網址)、Data(記憶體資料)、Stream(串流)、MultipartFormData(多段表單資料),四種涵蓋了日常所有情境。
最簡單的一種,直接把本機檔案的 URL 丟給它:
let fileURL = NSBundle.mainBundle().URLForResource("hangge", withExtension: "zip")
Alamofire.upload(.POST, "https://www.hangge.com/upload.php", file: fileURL!)
對應的 PHP 接收端要從原始輸入流讀取內容,因為這種上傳方式並非標準的 multipart 表單:
<?php
/**
* 接收串流檔案
* @param String $receiveFile 接收後要保存的檔名
* @return boolean
*/
function receiveStreamFile($receiveFile) {
$streamData = isset($GLOBALS['HTTP_RAW_POST_DATA']) ? $GLOBALS['HTTP_RAW_POST_DATA'] : '';
if (empty($streamData)) {
$streamData = file_get_contents('php://input');
}
if ($streamData != '') {
$ret = file_put_contents($receiveFile, $streamData, true);
} else {
$ret = false;
}
return $ret;
}
// 定義伺服器儲存路徑與檔名
$receiveFile = $_SERVER["DOCUMENT_ROOT"] . "/uploadFiles/hangge.zip";
$ret = receiveStreamFile($receiveFile);
echo json_encode(array('success' => (bool)$ret));
?>
大檔案上傳沒有進度條,使用者只會以為 App 當機了。加上 .progress 就能持續取得已送出的位元組數。要注意的是,這個 closure 為了效能考量不會在主執行緒呼叫,更新 UI 前必須自己 dispatch 回主 queue。
let fileURL = NSBundle.mainBundle().URLForResource("hangge", withExtension: "zip")
Alamofire.upload(.POST, "https://www.hangge.com/upload.php", file: fileURL!)
.progress { bytesWritten, totalBytesWritten, totalBytesExpectedToWrite in
print(totalBytesWritten)
// 此 closure 不在主 queue,更新 UI 請切回去
dispatch_async(dispatch_get_main_queue()) {
print("Total bytes written on main queue: \(totalBytesWritten)")
}
}
.responseJSON { response in
debugPrint(response)
}
執行後主控台會不斷印出已上傳的資料量,正好可以拿來驅動進度條。
這是最接近傳統 <form enctype="multipart/form-data"> 的做法,可以一次送出多個檔案,也能同時夾帶一般文字欄位。
let fileURL1 = NSBundle.mainBundle().URLForResource("hangge", withExtension: "png")
let fileURL2 = NSBundle.mainBundle().URLForResource("hangge", withExtension: "zip")
Alamofire.upload(
.POST,
"https://www.hangge.com/upload2.php",
multipartFormData: { multipartFormData in
multipartFormData.appendBodyPart(fileURL: fileURL1!, name: "file1")
multipartFormData.appendBodyPart(fileURL: fileURL2!, name: "file2")
},
encodingCompletion: { encodingResult in
switch encodingResult {
case .Success(let upload, _, _):
upload.responseJSON { response in
debugPrint(response)
}
case .Failure(let encodingError):
print(encodingError)
}
}
)
伺服器端就單純多了,用標準的 $_FILES 接收即可:
<?php
move_uploaded_file($_FILES["file1"]["tmp_name"],
$_SERVER["DOCUMENT_ROOT"] . "/uploadFiles/" . $_FILES["file1"]["name"]);
move_uploaded_file($_FILES["file2"]["tmp_name"],
$_SERVER["DOCUMENT_ROOT"] . "/uploadFiles/" . $_FILES["file2"]["name"]);
?>
如果後端是你自己能掌控的,串流方式最省事;若要相容既有的 PHP/Java 表單介面,就用 MultipartFormData。另外提醒,encodingCompletion 中的 .Success 取得 upload 物件後才能串 .progress 與 .responseJSON,這點和單檔上傳的鏈式寫法略有不同,是初學時最容易卡住的地方。