您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

iOS 開發實戰:用 PUT 方法上傳檔案到伺服器的完整設定與範例

編輯:iOS 相關教學

在 iOS 上做檔案上傳,POST 是最常見的選擇,但如果你面對的是 WebDAV 這類服務,PUT 才是正解。本文從 HTTP 方法談起,一路走完伺服器端設定與客戶端程式碼。

一、先釐清幾個常見的 HTTP 方法

  • GET:取得指定資源。
  • POST:向指定資源提交資料並要求處理,實務上常用於新增資源,早期也有 2MB 上傳大小的限制。
  • HEAD:只取得資源標頭,不取回內容。
  • PUT:以新內容替換指定資源。瀏覽器不會直接發出這個請求。
  • DELETE:刪除指定資源。

PUT 與 POST 的差異在於語意:POST 是「把資料交給某個程式處理」,PUT 是「把這個位址上的內容換成我給的這份」。因此 PUT 的 URL 通常直接包含目標檔名。

二、開啟 Apache 的 PUT 支援

以下以 macOS 自帶的 Apache 為例。

步驟 1:載入 WebDAV 模組

開啟終端機,編輯主設定檔:

cd /etc/apache2
sudo vim httpd.conf

在 vim 中搜尋 /httpd-dav.conf,把游標移到該行行首(按 0),用 x 刪掉行首的 #,然後 :wq 存檔離開。

步驟 2:調整 WebDAV 設定

cd /etc/apache2/extra
sudo vim httpd-dav.conf

在這個檔案裡有三處需要留意:

  • 把 Digest 改成 Basic,也就是調整用戶端的授權方式。
  • 確認存放使用者密碼的檔案路徑(例如 /usr/user.passwd)。
  • 確認被允許使用 PUT 請求的使用者名稱(例如 admin)。

改完一樣存檔離開。

步驟 3:建立密碼檔

cd /usr
sudo htpasswd -c /usr/user.passwd admin
ls -l
sudo chgrp www /usr/user.passwd
ls -l

執行 htpasswd 時會提示輸入兩次密碼。之後用 chgrp 把檔案群組改為 www,Apache 才有權限讀取。

步驟 4:建立必要目錄

# 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

步驟 5:重啟 Apache

sudo apachectl -k restart

重啟後用 ls -l 檢查,能看到 uploads、user.passwd、var 這三項,就代表設定正確了。

三、iOS 端:用 PUT 上傳檔案

整體流程是:組出 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 上傳其實比想像中單純——真正花時間的往往是伺服器端的權限設定,而不是客戶端那幾十行程式碼。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved