上傳圖片這個看似基本的功能,第一次做的時候往往要折騰一陣。這篇把 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 兼顧清晰度與流量。
// 以 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
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 實際檢查內容,並限制檔案大小上限。NSURLSession 的 uploadTaskWithRequest:fromData:,自行組 multipart/form-data 的 body,或用 AFNetworking 的 POST:parameters:constructingBodyWithBlock:,API 更簡潔。startAsynchronous 之後程式不會停下來等結果,成功與失敗的處理要寫在 delegate 方法(requestFinished: 與 requestFailed:)中,並在那裡回主線程更新 UI。UIGraphicsBeginImageContextWithOptions 縮圖,能大幅改善體驗。以上是小小心得,與大家分享 —— LC