如何在Laravel中用app()助手将带构造函数的自定义类注入服务容器

问题背景 #

当尝试将需要构造参数$name的MyCustomClass依赖注入到控制器时，服务容器无法自动解析该参数，抛出错误：

Unresolvable dependency resolving [Parameter #0 [ string $name ]] in class App\Http\Custom\MyCustomClass

相关代码如下：

MyCustomClass.php #

class MyCustomClass
{
    public string $name;

    public function __construct(string $name)
    {
        $this->name = $name;
    }

    public static function make(string $name)
    {
        return app(static::class, ['name' => $name]);
    }
}

TestController.php #

class TestController extends Controller
{
    public function __invoke(MyCustomClass $myCustomClass)
    {
        // 业务逻辑
    }
}

路由定义 #

Route::get('/depency/{filter}', TestController::class);

解决方案 #

1. 通过服务提供者绑定闭包（推荐全局使用） #

在App\Providers\AppServiceProvider的register方法中，为MyCustomClass注册绑定逻辑，告诉容器如何获取构造参数：

use App\Http\Custom\MyCustomClass;

public function register()
{
    $this->app->bind(MyCustomClass::class, function ($app) {
        // 从路由参数中获取$name的值（对应路由里的{filter}）
        $name = request()->route('filter');
        return new MyCustomClass($name);
    });
}

完成绑定后，控制器的依赖注入会自动生效，容器会执行闭包生成MyCustomClass实例并注入。

2. 手动传入参数（适合局部场景） #

如果不需要全局注入，可在控制器中直接通过app()助手或类的make方法手动传入参数：

public function __invoke(string $filter)
{
    // 方式1：使用类的静态make方法
    $myCustomClass = MyCustomClass::make($filter);
    
    // 方式2：直接调用app()助手
    $myCustomClass = app(MyCustomClass::class, ['name' => $filter]);
}

3. 上下文绑定（针对特定场景注入） #

如果仅需要在TestController中注入特定参数的MyCustomClass，可以使用上下文绑定：

public function register()
{
    $this->app->when(TestController::class)
              ->needs(MyCustomClass::class)
              ->give(function () {
                  return new MyCustomClass(request()->route('filter'));
              });
}

核心原理 #

Laravel服务容器自动解析依赖时，仅能处理无参数、有默认值，或已在容器中绑定的依赖。对于需要动态参数的类，必须显式告诉容器参数的获取方式，绑定闭包是最灵活的实现方式。

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