PHP 檔案上傳功能主要受 php.ini 核心參數控制。本文詳細解析各參數用途、大檔案上傳調整策略與常見陷阱。
| 參數 | 預設值 | 說明 |
|---|---|---|
| file_uploads | On | 總開關,必須為 On |
| upload_tmp_dir | 空(系統暫存目錄) | 上傳檔案暫存路徑,**必須設定且目錄可寫**,否則上傳失敗 |
| upload_max_filesize | 2M | 單一檔案最大允許大小 |
| post_max_size | 8M | POST 資料總大小上限,**必須 ≥ upload_max_filesize** |
| max_execution_time | 30 | 腳本最大執行秒數,大檔上傳需調大 |
| max_input_time | 60 | 解析輸入資料最大秒數,大檔上傳需調大 |
| memory_limit | 128M | 腳本記憶體上限,**需 > post_max_size** |
file_uploads = On
upload_tmp_dir = "D:/php_upload_tmp" ; 須預先建立資料夾並給寫入權限
upload_max_filesize = 20M
post_max_size = 20M
max_execution_time = 300
max_input_time = 300
memory_limit = 256M
<form action="upload.php" method="post" enctype="multipart/form-data">
<input type="hidden" name="MAX_FILE_SIZE" value="20971520"> <!-- 20MB,僅客戶端提示,不可信 -->
<input type="file" name="myfile">
<button type="submit">上傳</button>
</form>
$_FILES['myfile']['error'] == 1:超過 upload_max_filesize。$_FILES['myfile']['error'] == 2:超過表單 MAX_FILE_SIZE。$_FILES['myfile']['error'] == 6/7:暫存目錄不存在或不可寫(檢查 upload_tmp_dir)。$_POST 與 $_FILES 皆為空:超過 post_max_size。max_execution_time 或 max_input_time 過小。finfo_file())、副檔名、檔案內容魔數。