預設 PHP 僅允許 2MB 上傳,Nginx 預設 1MB。實際專案常需上傳百 MB 甚至 GB 級檔案。本文系統梳理 php.ini、Nginx、HTML 表單、前端分片 四層配置,並給出生產級檢查清單。
| 指令 | 預設 | 建議值(100MB 例) | 說明 |
|---|---|---|---|
| file_uploads | On | On | 總開關 |
| upload_max_filesize | 2M | 100M | 單檔上限 |
| post_max_size | 8M | 110M | 必須 > upload_max_filesize,含所有表單欄位 |
| max_execution_time | 30 | 300~3600 | 腳本最大執行秒數,大檔需拉長 |
| max_input_time | 60 | 300~3600 | 接收資料最大秒數 |
| memory_limit | 128M | 256M+ | 脚本記憶體上限,處理大檔/圖片處理需足夠 |
| upload_tmp_dir | 系統預設 | /data/tmp/upload | 指定專用臨時目錄,確保可寫、磁碟空間足夠、掛載 noexec,nodev |
關鍵關係:post_max_size > upload_max_filesize,否則大檔雖通過 Nginx 卻被 PHP 截斷。
# nginx.conf http {} 或 server {} 內
client_max_body_size 100m; # 請求體大小上限
client_body_buffer_size 128k; # 緩衝區,過小會頻繁寫臨時檔降速
client_body_temp_path /data/tmp/nginx_body 1 2; # 臨時檔路徑,需可寫
# 若為反向代理至上游(PHP-FPM/Node/Java),同步調大 proxy 體積
proxy_max_temp_file_size 0; # 禁止代理緩衝到磁碟,直接傳遞
proxy_request_buffering off; # 關閉請求緩衝,流式轉發大檔
重載生效:`nginx -s reload`。若採用 include 分散配置,請在對應 server 區塊內設定,而非僅在主 nginx.conf。
<form action="upload.php" method="post" enctype="multipart/form-data"> <input type="hidden" name="MAX_FILE_SIZE" value="104857600"> <!-- 100MB,僅瀏覽器提示,非強制 --> <input type="file" name="file" id="file"> <button type="submit">上傳</button> </form>
enctype="multipart/form-data" 必須,否則 `$_FILES` 為空。MAX_FILE_SIZE 僅為瀏覽器端建議,可被繞過,後端必須自行驗證。單次 HTTP 上傳 > 100MB 极易失敗(網路波動、超時、記憶體飆升)。生產環境建議:
POST /upload/chunk(接收片段)、POST /upload/merge(合併)API。fopen('ab') 追加寫入,避免記憶體爆炸。<?php
$input = fopen('php://input', 'rb');
$dest = fopen('/data/uploads/' . $filename, 'wb');
stream_copy_to_stream($input, $dest); // 直接管道,零拷貝
fclose($input);
fclose($dest);
?>
phpinfo() 確認配置生效(注意 .user.ini、php-fpm.conf 可能覆蓋)。client intended to send too large body。df -h、df -i(inode)。chown www-data:www-data /data/tmp/upload。request_terminate_timeout、request_slowlog_timeout 是否過小。按層層配置、驗證、壓測,即可穩定支援 GB 級上傳。