request()->query() 获取URL查询字符串参数，request()->route()->parameters() 获取路由定义的占位符参数；二者互不包含，需手动合并且query优先级高于route。

怎么区分 request()->query() 和 request()->route()->parameters()

URL 中的参数分两类：查询字符串（QueryString）和路由参数（Route Parameters），Laravel 用不同方式暴露它们，混用会导致取不到值或报错。

• request()->query() 只读取 URL 中 ?key=value 部分，比如 /users?status=active&limit=10 → 返回 ['status' => 'active', 'limit' => '10']
• request()->route()->parameters() 只读取定义在路由中的占位符，比如 Route::get('/users/{id}/edit', ...) 匹配 /users/123/edit → 返回 ['id' => '123']
• 两者互不包含：QueryString 不会出现在路由参数里，路由参数也不会自动塞进 query 数组

如何安全获取全部参数（合并 + 去重优先级）

业务中常需“所有参数合并在一个数组里”，但必须明确谁覆盖谁。Laravel 没有内置 allWithRoute() 这种方法，得手动合并，且注意顺序：

• 先取 request()->route()->parameters()（路由参数）
• 再用 request()->query() 合并进去，QueryString 优先级更高（符合常见预期：显式 ?id=999 应覆盖路由里的 {id}）
• 避免直接用 request()->all() —— 它还包含 POST body、上传文件等，可能引入脏数据或类型混乱

use Illuminate\Http\Request;

// 在控制器方法中
public function index(Request $request)
{
    $routeParams = $request->route()?->parameters() ?? [];
    $queryParams = $request->query();
    $allParams = array_merge($routeParams, $queryParams); // query 覆盖 route

    // 示例：/posts/5?author=john → ['id' => '5', 'author' => 'john']
    return response()->json($allParams);
}

request()->input() 和 request()->query() 的关键区别

很多人误以为 input() 是“万能取参”，但它实际是 query + request body + route 参数三者的混合读取，行为隐式且有陷阱：

• request()->input('id') 会依次查找：query → request body → route 参数 → 默认值
• 如果 POST 请求带了 id=7 字段，即使 URL 是 /users/5，input('id') 也返回 7，不是 5
• request()->query('id') 则只看 query，request()->route('id') 只看路由参数，更可控
• 对 GET 接口，推荐显式用 query() 或 route()，避免意外被 POST 数据干扰（哪怕当前没 POST）

遇到空数组或 null 的常见原因

调用 request()->route()->parameters() 返回空数组，不一定代表没参数，可能是以下情况：

• 当前请求未匹配到命名路由（比如中间件提前终止、404、或用了 Route::fallback()）→ $request->route() 为 null
• 路由定义没用命名参数，比如 Route::get('/users', ...) → 即使 URL 是 /users?id=1，route()->parameters() 仍是空
• 使用了可选参数但未提供值，如 {id?} 且 URL 是 /users/ → 该 key 不会出现在 parameters 数组中（不是 null，是根本不存在）
• 检查前务必加空值判断：if ($request->route()) { ... }

路由参数和查询参数本质不同，合并逻辑不能靠猜。写接口时，先明确哪些是资源标识（走 route），哪些是筛选控制（走 query），再决定是否合并、谁覆盖谁。否则上线后参数莫名被覆盖，debug 花半天。

# laravel  # 只看  # 很多人  # 半天  # 用了  # 更高  # 仍是  # 不存在  # 可选  # 出现在  # input  # 接口  # js  # json  # 路由  # 区别  # 中间件  # NULL  # if  # 字符串  # 带了