Laravel自定义扩展Request类在控制器类型提示时数据丢失问题

问题根因 #

你遇到的问题既不是PHP特性问题也不是Laravel底层bug，是两个用法错误叠加导致的：

1. 容器绑定不完整
   Laravel容器在解析控制器方法参数时，会优先查找和类型提示类名完全匹配的绑定。你在中间件中只给request这个别名绑定了填充后的实例，Laravel默认已将Illuminate\Http\Request别名指向request，所以类型提示原生Request时可以正常拿到填充后的实例。但你没有为自定义的App\Http\Request类绑定实例，容器遇到该类型提示时会直接new一个空白的新实例，自然没有请求数据。
2. 自定义Request实例初始化时机错误
   你把自定义Request实例放在中间件的构造函数中注入，中间件构造函数是在请求解析前就执行的，此时注入的实例本身就是未填充任何请求数据的空白对象，哪怕你后续做了数据同步，也存在逻辑冗余和隐患。

解决方案 #

方案1：官方推荐全局替换（无需中间件） #

这是Laravel替换全局Request类的标准实现方式，逻辑最稳定：

1. 改public/index.php中的请求捕获逻辑，把原生Request替换为你的自定义类：

// 原代码
// $request = Illuminate\Http\Request::capture();
// 替换为
$request = App\Http\Request::capture();

2. 在app/Providers/AppServiceProvider.php的register方法中添加别名绑定，让容器解析自定义Request类时直接返回全局实例：

public function register()
{
    $this->app->alias('request', \App\Http\Request::class);
}

改完删掉你之前写的自定义Request中间件即可，所有场景下类型提示原生或自定义Request都能正常拿到数据。

方案2：修复现有中间件逻辑 #

如果你必须用中间件的方式实现，修改中间件代码如下即可：

public function handle(Request $request, Closure $next){
    // 直接在handle方法中生成填充好的自定义Request实例
    $customRequest = \App\Http\Request::createFrom($request);
    // 同时绑定request别名和自定义类到填充后的实例
    $this->app->instance('request', $customRequest);
    $this->app->instance(\App\Http\Request::class, $customRequest);
    return $next($customRequest);
}

同时删掉中间件构造函数中注入CustomizedRequest的相关代码即可。

内容的提问来源于stack exchange，提问作者Rikaelus