提交包含大量輸入字段的表單 (如批量編輯、多行明細、動態表單) 時,`$_POST`、`$_GET`、`$_REQUEST` 超全局數組數據不完整、字段丟失,且無任何報錯日誌。
PHP 5.3.9+ 引入 max_input_vars 配置指令 (默認 1000),限制單次請求接收的最大輸入變量數量 (含多維數組展開後的總鍵數)。超出限制的變量會被靜默丟棄,不觸發錯誤,極難排查。
<?php
// 測試腳本: 提交 1500 個同名數組字段
echo 'max_input_vars = ' . ini_get('max_input_vars') . "\n";
echo '實際接收 $_POST 數量: ' . count($_POST, COUNT_RECURSIVE) . "\n";
// 若計數遠小於提交數量,即為此限制導致
; php.ini
max_input_vars = 5000 ; 根據業務峰值預估調整,建議 3000-10000
; 同步調整搭配項
max_input_nesting_level = 128 ; 多維數組嵌套深度限制
max_input_time = 60 ; 解析輸入數據最長秒數
重啟 PHP-FPM/Apache 生效:
systemctl restart php-fpm
# 或
service php8.2-fpm restart
# Apache mod_php
systemctl restart httpd
php_value max_input_vars 5000
php_value max_input_nesting_level 128
需修改 PHP-FPM 池配置 (/etc/php/8.2/fpm/pool.d/www.conf):
php_admin_value[max_input_vars] = 5000
php_admin_value[max_input_nesting_level] = 128
重啟 php-fpm。
ini_set('max_input_vars', 5000); // ❌ 錯誤:PHP_INI_PERDIR,運行時不可改
// 必須在 php.ini / .htaccess / FPM 配置中設置,並在請求開始前生效
單純調大限制僅是權宜之計,大量表單字段往往暗示設計可優化:
json_decode 還原。
// 前端
const payload = { items: [{id:1,qty:2},{id:2,qty:5}] };
fetch('/api/batch', {method:'POST', body: JSON.stringify(payload), headers:{'Content-Type':'application/json'}});
// 後端
$data = json_decode(file_get_contents('php://input'), true);
foreach ($data['items'] as $item) { ... }
php://input 解析原始數據: 繞過 PHP 內建解析器 (需自行解析 multipart/form-data 或 application/x-www-form-urlencoded),不受 max_input_vars 限制,但複雜度高,慎用。| 指令 | 默認值 | 作用範圍 | 說明 |
|---|---|---|---|
| max_input_vars | 1000 | PHP_INI_PERDIR | 單次請求最大輸入變量數 (含多維展開) |
| max_input_nesting_level | 64 | PHP_INI_PERDIR | 輸入數組最大嵌套層級 |
| max_input_time | 60 | PHP_INI_PERDIR | 解析 POST/GET 數據最長秒數 (-1 不限) |
| post_max_size | 8M | PHP_INI_PERDIR | POST 數據體總大小限制 (含文件) |
| upload_max_filesize | 2M | PHP_INI_PERDIR | 單文件上傳大小限制 |
max_input_vars 是為防止哈希碰撞 DoS 攻擊 (CVE-2011-4885) 引入的安全限制。遇到表單截斷,先通過 ini_get() 確認當前值,再根據業務量級調整至合理範圍 (通常 3000-10000 足夠)。長期來看,採用 JSON 統一載荷、分批 API 等現代化數據傳輸方式,才能從根本上避開此限制,提升系統擴展性與安全性。