萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 大檔案上傳完整設定指南:突破 8MB 限制

核心 php.ini 參數

上傳大檔案需同時調整四個關鍵參數,缺一不可:

參數預設值建議值 (大檔案)說明
file_uploadsOnOn啟用 HTTP 上傳功能
upload_max_filesize2M100M單一檔案最大尺寸
post_max_size8M120MPOST 總資料上限,**必須大於 upload_max_filesize**
upload_tmp_dir系統暫存目錄/var/www/tmp_upload指定專用暫存目錄,確保磁碟空間與權限

執行階段限制 (同樣關鍵)

大檔案上傳耗時較長,必須調整執行階段參數:

參數預設值建議值說明
max_execution_time30300 (秒)腳本最大執行時間,0 表無限制
max_input_time60300 (秒)解析輸入資料 (含上傳) 最大時間
memory_limit128M256M腳本記憶體上限,處理大檔案時可能需調高

Web Server 層面設定

Nginx

# nginx.conf 或 site conf
client_max_body_size 120m;
# 若使用 proxy_pass 還需設定
proxy_read_timeout 300s;
proxy_send_timeout 300s;

Apache (mod_php / php-fpm)

# 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) 配合後端合併策略:

  1. 前端將檔案切割為 5MB 區塊並行上傳。
  2. 後端接收區塊儲存至暫存目錄,記錄已上傳分片索引。
  3. 所有分片上傳完成後,合併為完整檔案並驗證校驗和 (MD5/SHA1)。
  4. 支援續傳:前端檢查本地檔案與伺服器已有分片,跳過已上傳部分。

常見錯誤排查清單

  • ✅ post_max_size > upload_max_filesize
  • ✅ max_input_time、max_execution_time 足夠大
  • ✅ upload_tmp_dir 目錄存在且 PHP 進程可寫入
  • ✅ Nginx/Apache client_max_body_size / LimitRequestBody 未限制更小
  • ✅ PHP-FPM request_terminate_timeout 未過短
  • ✅ 檢查 $_FILES['file']['error'] 代碼 (1=超過 upload_max_filesize, 2=超過 MAX_FILE_SIZE, 3=部分上傳, 4=無檔案, 6/7/8=暫存目錄/寫入失敗)

安全提醒

  • 嚴格驗證檔案型別 (MIME + 檔頭魔數),不可信任 $_FILES['type']。
  • 儲存路徑置於 Web 根目錄外,或以隨機檔名 + 無執行權限目錄提供下載。
  • 限制同時上傳數量與總佔用空間,防止 DoS。
copyright © 萬盛學電腦網 all rights reserved