您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 上傳圖片實作:ASIFormDataRequest 搭配 PHP 接收端完整教學

編輯:iOS 開發綜合

上傳圖片這個看似基本的功能,第一次做的時候往往要折騰一陣。這篇把 iOS 端與伺服器端兩邊的程式碼都寫出來,並說明容易忽略的權限問題。

核心觀念:先把圖片轉成二進位

上傳並不是把圖片檔直接丟到某個 URL,而是要先轉成二進位資料。iOS 內建兩個方法可以完成這件事:

UIImage *image = [UIImage imageNamed:@"8fca9.jpg"];

NSData *data  = UIImagePNGRepresentation(image);
NSData *data2 = UIImageJPEGRepresentation(image, 1);   // 1 代表最高畫質

兩者的差異在於輸出格式與檔案大小:PNG 支援透明背景但檔案較大;JPEG 不支援透明,第二個參數是壓縮品質(0.0 到 1.0),實務上行動網路環境常用 0.7 到 0.8 兼顧清晰度與流量。

iOS 端:用 ASIFormDataRequest 送出

// 以 URL 初始化請求
ASIFormDataRequest *request = [[ASIFormDataRequest alloc] initWithURL:url];

// 設定代理以接收回應
[request setDelegate:self];

// 加入要上傳的資料:資料本體、檔名、內容型別、表單欄位名稱
[request addData:data
        withFileName:@"testimage.png"
      andContentType:@"image/png"
              forKey:@"file"];

// 啟動非同步上傳
[request startAsynchronous];

這裡的 forKey:@"file" 必須與伺服器端接收時使用的欄位名稱一致,否則 PHP 那邊拿到的 $_FILES 會是空的。

伺服器端:用 PHP 接收

<?php
header("Content-type:text/html;charset=utf-8");

/*
 * $_FILES 是 PHP 處理二進位檔案上傳時使用的自動全域變數。
 * 以欄位名稱 file 為例,上傳後可取得:
 *
 *   $_FILES['file']['name']      客戶端檔案的原始名稱
 *   $_FILES['file']['type']      檔案的 MIME 型別,例如 image/gif
 *   $_FILES['file']['size']      已上傳檔案的大小(位元組)
 *   $_FILES['file']['tmp_name']  檔案在伺服器端暫存的檔名
 *   $_FILES['file']['error']     錯誤碼(PHP 4.2.0 起提供)
 *
 * 若表單中沒有選擇檔案,size 為 0、tmp_name 為 none。
 */

print_r($_FILES['file']);

$filename = $_FILES['file']['name'];

if (!$_FILES['file']['error']) {
    // move_uploaded_file 會把暫存檔搬到你指定的位置
    if (move_uploaded_file($_FILES['file']['tmp_name'], "./image/user/" . $filename)) {
        echo "上傳文件成功";
    }
} else {
    echo "文件上傳錯誤";
}
?>

最容易卡住的地方:資料夾權限

程式碼都對卻仍然上傳失敗,九成是權限問題。這裡要特別注意:需要開放的是整個路徑上所有層級目錄的寫入權限,而不只是最後那個 image/user 資料夾。在 Linux 上常見的處理是:

chmod -R 777 /var/www/html/image

但 777 是權限全開,正式環境應該改為只給 web 伺服器執行身分別具備的權限,例如:

chown -R www-data:www-data /var/www/html/image
chmod -R 755 /var/www/html/image

幾個實務上該補強的地方

  • 檔名不要直接用客戶端傳來的。$_FILES['file']['name'] 完全由使用者控制,可能包含 ../ 造成路徑穿越,也可能包含中文或特殊字元導致存檔失敗。建議用 uniqid() 或 UUID 產生新檔名,副檔名則從 MIME 型別推斷。
  • 要驗證型別與大小。不能信任 $_FILES['file']['type'](它也是客戶端送來的),應改用 getimagesize() 或 finfo 實際檢查內容,並限制檔案大小上限。
  • ASIFormDataRequest 已停止維護。它最後一次更新在 iOS 5 那個年代,在新版系統上會有相容問題。新專案請改用 NSURLSession 的 uploadTaskWithRequest:fromData:,自行組 multipart/form-data 的 body,或用 AFNetworking 的 POST:parameters:constructingBodyWithBlock:,API 更簡潔。
  • 記得處理非同步回呼。startAsynchronous 之後程式不會停下來等結果,成功與失敗的處理要寫在 delegate 方法(requestFinished: 與 requestFailed:)中,並在那裡回主線程更新 UI。
  • 大圖要先降採樣。直接上傳 4000 × 3000 的相機原圖,記憶體與流量都很可觀。上傳前用 UIGraphicsBeginImageContextWithOptions 縮圖,能大幅改善體驗。

以上是小小心得,與大家分享 —— LC

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