直接用 request()->query() 或 request()->input() 即可，无需封装 getParam()；Laravel 已提供语义清晰、支持默认值和类型转换的健壮方法；若需统一处理（如 trim、转小写），应封装为 cleanQueryInput() 等语义明确函数。
直接用 request()->query() 或 request()->input() 就够了，没必要封装 GET 参数获取函数——除非你反复处理相同逻辑（比如统一过滤、默认值 fallback、类型强制转换），否则额外封装反而增加维护成本和调用歧义。
为什么不用自己写 getParam() 这类函数
Laravel 已经通过 Illuminate\Http\Request 提供了语义清晰、健壮的 GET 参数访问方式：
-
request()->query('page')严格只读 query string（即 URL ?a=1&b=2 中的部分） -
request()->input('page')合并 query + request body（POST 表单也生效），更常用 - 两者都支持默认值：
request()->input('page', 1) - 自动类型转换可用：
request()->integer('page')、request()->boolean('active') - 不存在的键不会报错，返回 null 或默认值，无需手动
isset()判断
真要封装，也别叫 getParam() —— 容易和 input/query 混淆
如果你确实需要统一处理（例如所有接口 GET 参数都要 trim + 去空格 + 转小写），建议封装成语义明确的函数，比如 cleanQueryInput()，而不是模糊的 getParam()：
// app/Helpers/helpers.php
if (!function_exists('cleanQueryInput')) {
function cleanQueryInput($key, $default = null)
{
$value = request()->query($key);
if (is_string($value)) {
$value = trim(strtolower($value));
}
return $value ?: $default;
}
}
注意三点：
- 必须在
composer.json的"files"中注册该文件，并运行composer dump-autoload - 不要在函数里硬编码
request()以外的依赖（如app()或config()），否则测试难 mock - 避免在 helper 函数里做重逻辑（如 DB 查询、HTTP 请求），它应该只是参数预处理层
GET 参数在中间件里拿不到？先确认生命周期时机
常见错误是：在中间件中调用 request()->query() 返回空，但控制器里却有值。根本原因是请求体未被解析，或中间件注册顺序不对：
- Laravel 默认中间件（如
StartSession、VerifyCsrfToken）不干涉 query 解析，query 在请求进入时就已可用 - 如果你用了自定义中间件且调用了
$request->getContent()或$request->all()之前手动读取了 raw body，可能破坏 query 解析缓存（极少见，但存在） - 确保中间件在
app/Http/Kernel.php的$middleware或$middlewareGroups中注册，而非漏配
最常被忽略的一点：你在 Blade 模板或 Artisan 命令里调用 request() 是无效的——因为没 HTTP 上下文。这种场景下，request() 返回空实例，query() 必然为空。封装函数若没做上下文判断，就会静默失败。
