根本原因是FrankenPHP未自动继承max_input_vars配置，需在frankenphp.yaml中通过php.ini_values显式设置为≥5000，并同步调大post_max_size和upload_max_filesize，修改后必须重启实例。
handleRequest() 在 FrankenPHP 下对大批量字段提交会静默丢数据，根本原因是 PHP 的 max_input_vars 限制未被 FrankenPHP 运行时自动继承，且默认值（1000）远低于实际表单字段数。
FrankenPHP 中 max_input_vars 不生效的典型表现
表单含 200+ 复选框或集合字段（如 product[attributes][0][value]、product[tags][3]），提交后 $form->isSubmitted() 返回 false，dump($request->request->all()) 显示部分键缺失，$_POST 数组长度明显少于预期——这不是 Symfony 的 bug，而是底层 PHP 配置未穿透到 FrankenPHP 的 SAPI 层。
常见错误现象包括：
- 集合字段（
CollectionType）只绑定前 N 项，后续项完全消失 -
handleRequest()后$form->getData()中数组长度异常缩短 - 日志中无报错，但验证始终跳过（因数据未完整进入请求）
在 FrankenPHP 中正确设置 max_input_vars
FrankenPHP 不读取传统 php.ini，必须通过其专属配置机制注入运行时参数。直接修改系统 php.ini 无效。
立即学习“PHP免费学习笔记（深入）”；
操作步骤如下：
- 编辑 FrankenPHP 的
frankenphp.yaml（通常位于项目根目录或config/下） - 在
workers:或全局php:节点下添加ini_values:块 - 显式设置
max_input_vars至安全值（建议 ≥5000）
php:
ini_values:
max_input_vars: 5000
post_max_size: 100M
upload_max_filesize: 100M
⚠️ 注意：post_max_size 和 upload_max_filesize 也需同步调大，否则大表单可能被 FrankenPHP 在解析前截断；修改后必须重启 FrankenPHP 实例（frankenphp stop && frankenphp start），仅 reload 不生效。
验证是否真正生效的三步检查法
别只信配置文件，用运行时证据确认：
- 在控制器中加一行：
dump(ini_get('max_input_vars'));—— 必须输出5000，而非1000 - 提交一个含 1200 个同名复选框的测试表单（如
<input type="checkbox" name="items[]">x1200），然后dump(count($_POST['items'] ?? []))—— 应等于 1200 - 检查
$request->request->count()是否与原始字段总数基本一致（允许 CSRF 等保留字段偏差 ≤5）
如果其中任一检查失败，说明配置未加载或被其他层覆盖（例如 Docker 容器内嵌的 php.ini 优先级更高）。
集合字段批量提交仍失败？检查 by_reference 和原型结构
即使 max_input_vars 正确，CollectionType 仍可能“丢”整个子项，原因常在表单类型定义本身：
- 确保集合字段配置了
'by_reference' => false，否则 Symfony 会跳过对象重建，导致新增项无法映射 - 前端生成的 prototype 必须与服务器端
getPrototype()输出完全一致（包括字段名嵌套层级、索引命名方式） - 若使用 JS 动态添加集合项，必须调用
form.add()并触发data-prototype替换，不能手动拼 HTML 字符串（易破坏命名路径）
一个容易被忽略的细节：FrankenPHP 的 HTTP/3 支持可能导致某些 JS 拼接的表单字段名在二进制分帧时被截断，建议对动态生成的字段名做 encodeURIComponent() 编码后再插入 DOM。
