Laravel解析复选框为数组需前端name加[]后缀,如name="category[]",否则request('category')仅返回最后一个值;判断参数存在应使用request()->filled()而非if(request('xxx')),并注意字符串与数字的严格比较。

复选框用 name="xxx[]" 才能被 Laravel 解析为数组
如果前端写成 <input name="category" value="1">,哪怕用户勾了多个,request('category') 也只拿到最后一个值。必须加 [] 后缀:<input name="category[]" value="1">、<input name="category[]" value="3">,Laravel 才会自动聚合成 ['1', '3'] 数组。
常见错误:后端用 request('category') 判断时发现是字符串(比如 "1,3"),误以为是框架 bug —— 实际是前端漏写了 [],导致浏览器按同名覆盖规则只提交最后一个。
- 检查浏览器开发者工具 Network → Form Data,确认提交的是
category[]=1&category[]=3还是category=1,3 - Blade 中循环渲染时别手抖漏掉
[]:name="tags[]"不等于name="tags" - 若必须接收逗号分隔字符串(如来自第三方链接),就别指望 Laravel 自动转数组,得手动
explode(',', request('category'))
request()->filled('xxx') 比 request('xxx') 更安全判断是否存在
request('category') 在参数未传时返回 null,但 if (request('category')) 会把 null、0、"0"、空字符串全判为 false;而 request()->filled('category') 专用于判断「该 key 是否在请求中显式存在且非空」,排除所有 falsy 值干扰。
典型陷阱:request('level') == 0 在没传 level 参数时,null == 0 为 true,导致 checkbox 全部误勾。
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
- 多值场景(如
category[])优先用is_array(request('category')) && in_array($id, request('category')) - 单值场景(如
level)用request()->has('level') && request('level') === '0',注意是字符串'0',不是数字0 - 不要用
request('xxx') !== null,语义不清且易漏掉空字符串等边界
GET 请求里复选框参数实际走 query,不是 post 或 json
筛选表单通常用 GET 提交(URL 可分享、可刷新),所以参数都在 URL 查询串里,request()->query('category') 和 request('category') 效果一样,但后者更通用。不过要注意:如果同时有 POST 表单和 URL 参数同名,request('xxx') 会合并两者,可能出意料之外的覆盖。
例如:?category[]=1&category[]=2 + POST body 含 category[]=3,request('category') 返回 ['1','2','3'] —— 大部分筛选场景不需要 POST 数据参与,建议明确用 request()->query('category') 避免混淆。
- 调试时直接打印
request()->query()看原始结构,比猜更可靠 - JSON 请求里复选框不会自动变成数组,因为浏览器不发 JSON 给 GET,这点不用纠结
- 重定向后保留筛选状态,靠的是 URL query 本身,不是 session 或 cache
空值和字符串比较必须严格区分类型
Laravel 的 request() 方法返回的永远是字符串或 null,哪怕你传的是 ?active=0,request('active') 也是字符串 "0"。用 == 或 != 会触发 PHP 类型转换,"0" == false、null == 0 全为 true,逻辑就崩了。
真正要判断“用户是否勾了值为 0 的 checkbox”,得确认两点:参数存在 + 值等于字符串 "0"。
- 别写
request('level') == 0,改用request()->has('level') && request('level') === '0' - 需要布尔转换时,用
filter_var(request('active'), FILTER_VALIDATE_BOOLEAN),它能把"1"、"true"、"on"转成 true,"0"、"false"、""转成 false - 数据库字段是 tinyint(1),存前记得 cast:
(int) request('active'),而不是直接塞字符串
[]、多打个空格、大小写不一致,request('Category') 就拿不到 category。调试第一件事:看 Network 里的真实请求键名,别信自己写的变量名。

















