laravel 本身没有「把 get 数组参数自动转成集合对象」的内置机制，但可通过 request()->collect() 或 collect(request()->all()) 快速实现；需注意其仅做一层包装，嵌套结构需手动递归展平为路径式键名（如 'user.role' => 'admin'）才能满足特定使用场景。
直接说结论：Laravel 本身没有「把 GET 数组参数自动转成集合对象」的内置机制，但你可以用 request()->collect() 或 collect(request()->all()) 快速达成目的——前提是理解清楚「数组参数」在 PHP/Laravel 中的实际结构和边界情况。
GET 数组参数长什么样？先看真实请求结构
比如 URL 是：/search?tags[]=php&tags[]=laravel&user[role]=admin&user[active]=1，PHP 解析后，$_GET 实际是：
[ 'tags' => ['php', 'laravel'], 'user' => ['role' => 'admin', 'active' => '1'] ]
这种嵌套结构不能直接被 collect() 拍平成扁平集合；如果你期望的是一个包含所有键值对的 Collection（如 ['tags.0' => 'php', 'tags.1' => 'laravel', 'user.role' => 'admin']），就得自己递归展开。
- 原生
request()->all()返回的是普通 PHP 数组，不带方法链式调用能力 -
request()->collect()是 Laravel 9.2+ 新增方法，等价于collect(request()->all())，但只做一层包装，不递归 - 浏览器对
[]和点号命名（user.name）的支持不一致，Laravel 默认不解析点号为嵌套，除非你手动处理
用 collect() + 递归 flatten 处理嵌套数组参数
如果需要把 GET 参数完全展平为「路径式键名」的集合（例如用于搜索条件合并、日志记录或透传给第三方 API），可以这样写：
function flattenRequest(array $data, string $prefix = ''): array
{
$result = [];
foreach ($data as $key => $value) {
$newKey = $prefix === '' ? $key : $prefix . '.' . $key;
if (is_array($value)) {
$result += flattenRequest($value, $newKey);
} else {
$result[$newKey] = $value;
}
}
return $result;
}
$flatCollection = collect(flattenRequest(request()->all()));
注意：flattenRequest() 不会处理 tags[] 中的数字索引自动转为 tags.0 ——PHP 已经帮你做了，但你要确认前端没发错格式（比如发成 tags[0] 和 tags[1] 才能稳定映射）。
- 不要依赖
request()->query()做二次解析，它和all()行为一致，只是过滤了 content-type 为 JSON 的请求体 - 若参数含空字符串或
null，collect()仍会保留它们，需显式用filter()清洗 - 大量嵌套参数时，递归深度可能触发 PHP 栈限制，生产环境建议加深度控制
别踩坑：GET 参数里的空数组、null、0 怎么办？
Laravel 的 request()->all() 对空数组（?filters[]=）、null（?id=）、数字 0 都照单全收，但集合操作容易误判：
-
collect(['a' => null, 'b' => ''])->filter()会同时丢掉a和b，因为默认过滤 falsy 值；要用filter(fn($v) => $v !== null)精确控制 -
request()->filled('tags')对?tags[]=返回true，但collect(request()->get('tags'))->isEmpty()是true——语义完全不同，别混用 - GET 参数永远是字符串，
0、false、''全部是字符串类型，collect()->map(fn($v) => (int)$v)强转前请确认字段语义是否允许
真正麻烦的不是怎么转，而是你得想清楚：这个「集合对象」后续要用来做什么。查数据库？要防 SQL 注入；拼接第三方 URL？得重新编码；存缓存？要考虑序列化兼容性。参数结构一旦扁平化，原始嵌套语义就丢了，这点很容易被忽略。
