檔案上傳看起來簡單,卻是 Web 應用最容易被攻擊的環節之一。本文從最基礎的表單寫起,一路談到 MIME 偽裝、副檔名繞道與暫存檔驗證。
要讓使用者上傳檔案,得先提供一個表單。上傳的內容屬於特殊資料,與一般 POST 欄位不同,所以必須設定專用的編碼類型:
<form action="upload.php" method="POST" enctype="multipart/form-data">
</form>
這個 enctype 屬性常被忽略,但當同一個 POST 請求中既有一般欄位又有檔案時,就一定要加上,這麼做也能提高跨瀏覽器的相容性。
接著加上檔案欄位:
<input type="file" name="attachment">
多數瀏覽器會把它渲染成一個文字框加一顆瀏覽按鈕,使用者可以直接輸入路徑,也可以從本機挑選檔案。Safari 早期版本只允許用瀏覽的方式選檔。這個控制項的預設外觀向來被詬病,需要時可以用 CSS 客製化。
<p>請上傳你的附件:</p>
<form action="upload.php" method="POST" enctype="multipart/form-data">
<input type="file" name="attachment">
<input type="submit" value="上傳附件">
</form>
大小限制在 php.ini 中設定。upload_max_filesize 控制單一檔案的上限,post_max_size 則是整個表單所有資料加起來的上限。兩者必須搭配正確:post_max_size 一定要大於 upload_max_filesize,因為前者涵蓋後者。

圖一、顯示於 Firefox 中的上傳表單
表單送出後,請求會打到 upload.php。先把 $_FILES 印出來看看:
header('Content-Type: text/plain');
print_r($_FILES);
上傳一張圖片後,輸出大致如下:
Array
(
[attachment] => Array
(
[name] => boy.jpg
[type] => image/jpeg
[tmp_name] => D:\xampp\tmp\php1168.tmp
[error] => 0
[size] => 11490
)
)
這些就是關於這次上傳的全部資訊。但請記住一件事:這些值全部來自用戶端,隨時可能被竄改。永遠不要信任它們。
改用一個純文字檔來實驗,內容是:
360weboy
360days
Life Of A Web Boy
upload.php 的輸出:
Array
(
[attachment] => Array
(
[name] => test.txt
[type] => text/plain
[tmp_name] => D:\xampp\tmp\php51C0.tmp
[error] => 0
[size] => 40
)
)
對應的請求內容(省略部分選填標頭):
POST /upload.php HTTP/1.1
Host: www.example.com
Referer: https://www.example.com/
Content-Type: multipart/form-data; boundary=---------------------------24464570528145
Content-Length: 234
-----------------------------24464570528145
Content-Disposition: form-data; name="attachment"; filename="test.txt"
Content-Type: text/plain
360weboy
360days
Life Of A Web Boy
-----------------------------24464570528145--
幾個關鍵欄位值得留意:name 是表單欄位名稱,filename 是使用者的原始檔名,Content-Type 是檔案的 MIME 類型。空行之後,才是檔案的實際內容。
要確認 tmp_name 指向的檔案真的是這次上傳產生的,而不是被指向 /etc/passwd 之類的系統檔案,必須用 is_uploaded_file():
$filename = $_FILES['attachment']['tmp_name'];
if (is_uploaded_file($filename)) {
/* 確認是上傳的檔案 */
}
如果上傳成功後要把檔案內容讀出來顯示給使用者,這個檢查尤其重要。
$allow_mimes = array(
'image/png',
'image/x-png',
'image/gif',
'image/jpeg',
'image/pjpeg'
);
$image = $_FILES['attachment'];
if (!in_array($image['type'], $allow_mimes)) {
die('對不起,你上傳的檔案格式不正確;我們只接受圖片。');
}
// 繼續處理
只做上面這一步並不夠。攻擊者可以製作一張 jpg 圖片,在它的詮釋資料中塞入惡意的 PHP 程式碼,再把副檔名改成 php:
File name : image.jpg
File size : 182007 bytes
Resolution : 1197 x 478
Comment : passthru($_POST['cmd']); __halt_compiler();
這個檔案上傳時會順利通過 MIME 檢查,被當成一張圖片,而其中的程式碼一旦被執行,後果不堪設想。
$allow_mimes = array(
'image/png' => '.png',
'image/x-png' => '.png',
'image/gif' => '.gif',
'image/jpeg' => '.jpg',
'image/pjpeg' => '.jpg'
);
$image = $_FILES['attachment'];
if (!array_key_exists($image['type'], $allow_mimes)) {
die('對不起,你上傳的檔案格式不正確;我們只接受圖片。');
}
// 取出不含副檔名的檔名
$filename = substr($image['name'], 0, strrpos($image['name'], '.'));
// 改用白名單中的副檔名
$filename .= $allow_mimes[$image['type']];
// 繼續處理
關鍵在於不要沿用使用者送來的副檔名。即使檔案的詮釋資料中藏了 PHP 程式碼,只要存檔時副檔名被強制改成圖片格式,那些程式碼就不會被當成指令執行。這個改寫對正常上傳的圖片完全沒有負面影響。
以上檢查都做完,就可以用 move_uploaded_file() 存檔:
$tmp_filename = $_FILES['attachment']['tmp_name'];
$filename = '/path/to/attachment.txt';
if (move_uploaded_file($tmp_filename, $filename)) {
/* 已成功從暫存目錄移到目標位置 */
}
檔案大小限制則可用 filesize() 取得後自行判斷。
上面這套流程放在今天只能算基本盤,正式上線前建議再補幾項:
不要用使用者提供的檔名存檔。改成自行產生隨機名稱(例如 bin2hex(random_bytes(16))),能同時避開路徑穿越、檔名衝突與特殊字元問題。
上傳目錄不可執行。在伺服器設定中禁止該目錄解析 PHP,這是最有效的一道防線。
用 getimagesize() 驗證真實型別。它會實際讀取檔案內容,比對檔名與宣告的 MIME 可靠得多。
檢查 error 欄位。$_FILES['attachment']['error'] 不為 UPLOAD_ERR_OK 時代表上傳根本沒成功,卻常被忽略而導致後續處理出錯。
限制檔案數量與總容量。否則一次請求就能把磁碟寫滿。
檔案上傳的複雜度,幾乎全部來自「輸入不可信」這件事。把每一個來自用戶端的欄位都當成敵人看待,通常就不會出大問題。