不能直接在控制器里用request()->query()读GET参数，因其破坏可测试性、复用性和类型安全，且参数校验分散、无法统一过滤；应通过容器绑定封装GetParams类，自动注入并提供int/string/bool等类型安全方法。
为什么不能直接在控制器里用 request()->query() 读 GET 参数
因为硬编码读取会破坏可测试性、复用性和类型安全——比如 request()->query('page', 1) 返回的是字符串 "1"，后续还得手动 cast；参数校验逻辑散落在各处，改个默认值要搜半天；单元测试时还得 mock request 实例。
更关键的是：一旦需要对所有 GET 请求做统一处理（如自动 trim 字符串、过滤 XSS、转换空字符串为 null），靠控制器里重复写 request()->query() 根本不可控。
所以得把参数读取逻辑收口到容器绑定的可复用对象里，让 Laravel 自动注入，而不是手动调用 request 实例。
如何用容器绑定封装 GET 参数读取类
新建一个类（比如 App\Http\Requests\GetParams），它不继承 FormRequest，而是专注解析 query string。在 AppServiceProvider::register() 里绑定：
$this->app->singleton(GetParams::class, function ($app) {
return new GetParams($app->make('request')->query());
});
这个绑定的关键点是：request 是 Laravel 的服务名，$app->make('request') 拿到的是当前请求实例，它的 query() 方法返回的是 ParameterBag，已经完成了解析和解码，比 raw query string 更可靠。
类内部可以封装常用方法：
-
int(string $key, int $default = 0)：自动 cast 为 int，无效时返回默认值 -
string(string $key, string $default = '')：trim 后返回，空字符串转为$default -
bool(string $key, bool $default = false)：识别"1"、"true"、"on"等语义 -
exists(string $key)：区分「参数不存在」和「参数存在但为空」
绑定后怎么在控制器里安全使用
直接类型提示注入即可，Laravel 容器会自动解析：
public function index(GetParams $get)
{
$page = $get->int('page', 1);
$search = $get->string('q');
$active = $get->bool('active');
// 不用再担心 $page 是字符串 "1"，也不用重复写 null coalescing
}
注意两点：
- 不要在构造函数里绑定依赖（比如
new GetParams(request())），否则无法被容器管理，也测不了 - 如果某些接口需要不同行为（比如某个接口允许空字符串不转 null），就另起一个绑定名，比如
LooseGetParams，避免“一个类扛所有”导致逻辑耦合 - 别把验证逻辑塞进这个类——参数读取和验证是两层事，验证仍该走
FormRequest或独立 validator
容易被忽略的兼容性细节
Laravel 的 request()->query() 在 CLI 环境（比如 artisan 命令）下返回空 ParameterBag，不会报错，但你的 GetParams 类如果没处理好，默认值可能意外生效。建议在构造函数里加判断：
public function __construct(ParameterBag $bag)
{
// CLI 下 $bag->all() 是 []，但不会 null，所以不用额外判 null
$this->params = $bag;
}
另外，如果你用了 Laravel Octane，request 实例是长生命周期的，但 query() 每次调用都返回新 ParameterBag，所以绑定 singleton 是安全的——每次请求拿到的仍是当前请求的 query 数据。
真正要注意的是：别在 config/app.php 的 providers 里提前注册这个绑定，必须在 AppServiceProvider::register() 里，否则 request 服务还没注册，$app->make('request') 会抛 BindingResolutionException。
