在 iOS 上做檔案上傳,POST 是最常見的選擇,但如果你面對的是 WebDAV 這類服務,PUT 才是正解。本文從 HTTP 方法談起,一路走完伺服器端設定與客戶端程式碼。
PUT 與 POST 的差異在於語意:POST 是「把資料交給某個程式處理」,PUT 是「把這個位址上的內容換成我給的這份」。因此 PUT 的 URL 通常直接包含目標檔名。
以下以 macOS 自帶的 Apache 為例。
開啟終端機,編輯主設定檔:
cd /etc/apache2 sudo vim httpd.conf
在 vim 中搜尋 /httpd-dav.conf,把游標移到該行行首(按 0),用 x 刪掉行首的 #,然後 :wq 存檔離開。
cd /etc/apache2/extra sudo vim httpd-dav.conf
在這個檔案裡有三處需要留意:
Digest 改成 Basic,也就是調整用戶端的授權方式。/usr/user.passwd)。admin)。改完一樣存檔離開。
cd /usr sudo htpasswd -c /usr/user.passwd admin ls -l sudo chgrp www /usr/user.passwd ls -l
執行 htpasswd 時會提示輸入兩次密碼。之後用 chgrp 把檔案群組改為 www,Apache 才有權限讀取。
# DavLockDB 相關檔案 sudo mkdir -p /usr/var sudo chown -R www:www /usr/var # 上傳檔案的存放位置 sudo mkdir -p /usr/uploads sudo chown -R www:www /usr/uploads
sudo apachectl -k restart
重啟後用 ls -l 檢查,能看到 uploads、user.passwd、var 這三項,就代表設定正確了。
整體流程是:組出 URL、建立帶 PUT 動詞的 request、掛上 Basic 授權標頭、最後交給 NSURLSession 的 upload task 執行。
#import "KUViewController.h"
#import "KUProgress.h"
@interface KUViewController () <NSURLSessionTaskDelegate>
// 顯示上傳進度的自訂 view,繼承自 UIView
@property (weak, nonatomic) IBOutlet KUProgress *progressView;
@end
@implementation KUViewController
- (void)viewDidLoad
{
[super viewDidLoad];
[self putFile];
}
/**
* 用 PUT 方法上傳檔案,不經過瀏覽器
*/
- (void)putFile
{
// 1. 組出 URL(協議 + 主機 + 路徑 + 伺服器上的檔名)
// 注意 PUT 與 POST 不同:POST 的 URL 指向接收程式,
// PUT 的 URL 直接指向要保存的檔案位置
NSString *urlStr = @"https://localhost/046.Post提交用戶隱私數據&MD5加密.mp4";
// 1.1 先做 URL 編碼,處理中文與特殊字元
urlStr = [urlStr stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
NSURL *url = [NSURL URLWithString:urlStr];
// 2. 建立 request(預設方法是 GET,必須改寫)
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
// 2.1 指定 HTTP 方法
request.HTTPMethod = @"PUT";
// 2.2 加上授權資訊
/**
* Base64 是目前網路上最通行的編碼方式之一,可把二進位資料轉成字串,
* 接收方拿到字串後再解回二進位檔案。它既能編碼也能解碼。
*
* 授權三步驟:
* (1) 授權字串格式:使用者名稱:密碼
* (2) 授權模式:Basic + Base64 編碼後的授權字串
* (3) 把結果寫進 HTTP 標頭的 Authorization 欄位
*/
NSString *authStr = @"admin:admin";
authStr = [self authBase64:authStr]; // 轉成 Base64
NSString *authBase64 = [NSString stringWithFormat:@"Basic %@", authStr];
[request setValue:authBase64 forHTTPHeaderField:@"Authorization"];
// 3. 建立 session
NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
NSURLSession *session = [NSURLSession sessionWithConfiguration:config
delegate:self
delegateQueue:[[NSOperationQueue alloc] init]];
// 3.1 取得要上傳的檔案
NSURL *fileUrl = [[NSBundle mainBundle] URLForResource:@"01.Post提交用戶隱私數據&MD5加密.mp4"
withExtension:nil];
// 3.2 啟動上傳任務
[[session uploadTaskWithRequest:request fromFile:fileUrl] resume];
// 如果不需要進度條,改用帶 completionHandler 的版本即可:
// NSURLSessionUploadTask *task =
// [session uploadTaskWithRequest:request fromFile:fileUrl
// completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
// NSString *str = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
// NSLog(@"str = %@", str);
// }];
}
#pragma mark -- 代理方法
// 上傳進度回報
- (void)URLSession:(NSURLSession *)session
task:(NSURLSessionTask *)task
didSendBodyData:(int64_t)bytesSent
totalBytesSent:(int64_t)totalBytesSent
totalBytesExpectedToSend:(int64_t)totalBytesExpectedToSend
{
CGFloat value = (CGFloat)totalBytesSent / totalBytesExpectedToSend;
[[NSOperationQueue mainQueue] addOperationWithBlock:^{
self.progressView.progress = value;
}];
NSLog(@"上傳進度:value = %.03lf", value);
}
// session 失效(例如上傳失敗)
- (void)URLSession:(NSURLSession *)session
didBecomeInvalidWithError:(NSError *)error
{
NSLog(@"上傳失敗");
}
// 把字串轉成 Base64 編碼
- (NSString *)authBase64:(NSString *)authStr
{
NSData *data = [authStr dataUsingEncoding:NSUTF8StringEncoding];
return [data base64EncodedStringWithOptions:0];
}
@end
URL 編碼不能省。檔名裡只要有中文或 & 這類字元,不做百分號編碼就會直接組出無效的 NSURL。
PUT 的 URL 要包含檔名。這是它和 POST 最直觀的差別,也是許多人第一次寫 PUT 時最常出錯的地方。
Basic 授權只是編碼,不是加密。Base64 任何人都能還原,所以正式環境請務必搭配 HTTPS,否則帳密等於明文傳輸。
進度更新要回主線程。didSendBodyData 是在背景佇列被呼叫的,直接操作 UI 會出問題,因此範例中透過 NSOperationQueue mainQueue 切回主執行緒。
撐過以上幾關,PUT 上傳其實比想像中單純——真正花時間的往往是伺服器端的權限設定,而不是客戶端那幾十行程式碼。