PHP 5.3.9 引入 max_input_vars 指令(預設 1000),限制單次請求接收的輸入變數總數($_GET、$_POST、$_COOKIE 合計)。超過限制的變數會被截斷,導致表單資料遺失、陣列索引缺失等難以排查的錯誤。
<input name="ids[]"> 數百個選項data[0][field1], data[0][field2]... 每列多欄位; php.ini
max_input_vars = 5000
; 建議同步調大:
max_input_time = 120
post_max_size = 64M
memory_limit = 256M
php_value max_input_vars 5000
max_input_vars = 5000
<?php
// ❌ 無效!max_input_vars 屬於 PHP_INI_PERDIR,運行時 ini_set 不生效
ini_set('max_input_vars', 5000);
<?php
// 檢查當前值
echo 'max_input_vars: ' . ini_get('max_input_vars') . "\n";
// 測試:建立 1500 個輸入欄位的表單
// 若 $_POST 只收到 1000 個,表示未生效或被其他層級攔截(如 Suhosin、Nginx client_max_body_size)
?>
| 指令 | 預設值 | 限制範圍 | 說明 |
|---|---|---|---|
max_input_vars | 1000 | 請求 | 輸入變數總數(含多維陣列展開計數) |
max_input_nesting_level | 64 | 請求 | 陣列巢狀深度 |
post_max_size | 8M | 請求 | POST 資料體總大小(含檔案) |
upload_max_filesize | 2M | 單檔 | 單一上傳檔案大小 |
memory_limit | 128M | 腳本 | 腳本記憶體上限 |
max_execution_time | 30 | 腳本 | 最大執行秒數 |
max_input_time | 60 | 請求 | 解析輸入資料最大秒數(-1 不限) |
Suhosin suhosin.post.max_vars | 1000 | 請求 | 搭建環境若裝 Suhosin 也需調整 |
Nginx client_max_body_size | 1M | 請求 | 反向代理層面的 Body 大小限制 |
item[] 每個元素計 1 個變數data[0][name]、data[0][email] 每個葉子節點計 1 個$_FILES 不計入 max_input_vars(但受 post_max_size、upload_max_filesize 限制)E_WARNING:Input variables exceeded 1000. To increase the limit change max_input_vars in php.ini.前端將大表單拆分為多個步驟或分頁,單次提交控制在 500 變數內。
<?php
// 前端:JSON.stringify(formData) → application/json
// 後端:
$input = json_decode(file_get_contents('php://input'), true);
// 不受 max_input_vars 限制(不經過 PHP 表單解析器)
?>
匯入 CSV/Excel,後端解析,避免海量表單欄位。
; php.ini
variables_order = "GPCS" ; 移除 E (環境變數) 減少變數數量
; 或僅保留需要的:GPC
max_input_vars 是防禦 HashDoS 攻擊的保護機制,預設 1000 適用多數場景。遇到合理業務需求超過時,優先考慮架構調整(JSON、分批、檔案上傳),確需調大時同步評估 post_max_size、memory_limit、max_input_time、Web 伺服器層限制,並監控記憶體與 CPU 使用率防範資源耗盡。