上傳大檔案需同時調整四個關鍵參數,缺一不可:
| 參數 | 預設值 | 建議值 (大檔案) | 說明 |
|---|---|---|---|
file_uploads | On | On | 啟用 HTTP 上傳功能 |
upload_max_filesize | 2M | 100M | 單一檔案最大尺寸 |
post_max_size | 8M | 120M | POST 總資料上限,**必須大於 upload_max_filesize** |
upload_tmp_dir | 系統暫存目錄 | /var/www/tmp_upload | 指定專用暫存目錄,確保磁碟空間與權限 |
大檔案上傳耗時較長,必須調整執行階段參數:
| 參數 | 預設值 | 建議值 | 說明 |
|---|---|---|---|
max_execution_time | 30 | 300 (秒) | 腳本最大執行時間,0 表無限制 |
max_input_time | 60 | 300 (秒) | 解析輸入資料 (含上傳) 最大時間 |
memory_limit | 128M | 256M | 腳本記憶體上限,處理大檔案時可能需調高 |
# nginx.conf 或 site conf
client_max_body_size 120m;
# 若使用 proxy_pass 還需設定
proxy_read_timeout 300s;
proxy_send_timeout 300s;
# httpd.conf 或 .htaccess
LimitRequestBody 125829120 # 120MB (位元組)
# 若使用 mod_fcgid
FcgidMaxRequestLen 125829120
<form action="upload.php" method="post" enctype="multipart/form-data">
<input type="hidden" name="MAX_FILE_SIZE" value="104857600"> <!-- 100MB,瀏覽器端提示用 -->
<input type="file" name="bigfile">
<button type="submit">上傳</button>
</form>
超過 500MB 或網路不穩定環境,建議採用前端分片 (如 plupload、uppy、WebUploader) 配合後端合併策略:
post_max_size > upload_max_filesizemax_input_time、max_execution_time 足夠大upload_tmp_dir 目錄存在且 PHP 進程可寫入client_max_body_size / LimitRequestBody 未限制更小request_terminate_timeout 未過短$_FILES['file']['error'] 代碼 (1=超過 upload_max_filesize, 2=超過 MAX_FILE_SIZE, 3=部分上傳, 4=無檔案, 6/7/8=暫存目錄/寫入失敗)