构造器注入是laravel 6最推荐的依赖注入方式,通过类型提示自动解析依赖;需由容器创建实例、接口须显式绑定,禁止手动new。

Laravel 6 的服务容器支持多种依赖注入方式,其中构造器注入(Constructor Injection)是官方最推荐、最常用的方式,它让依赖关系清晰、可测试性强,且完全由容器自动完成解析。
构造器注入的原理和写法
当你在控制器、服务类、中间件等类的 __construct() 方法中声明类型提示参数时,Laravel 会通过 PHP 反射(Reflection)自动从服务容器中解析并注入对应实例。
✅ 正确写法(自动注入):
<?php namespace App\Http\Controllers;
use App\Services\OrderService;
use App\Contracts\LoggerInterface;
use Illuminate\Http\Controller;
class OrderController extends Controller
{
protected $orderService;
protected $logger;
// Laravel 自动解析 OrderService 和 LoggerInterface 实例
public function __construct(OrderService $orderService, LoggerInterface $logger)
{
$this->orderService = $orderService;
$this->logger = $logger;
}
public function store()
{
$this->logger->info('Order processing started');
return $this->orderService->create(request()->all());
}
}
⚠️ 注意事项:
- 类必须由 Laravel 容器创建(如通过路由访问、
app(OrderController::class)),不能手动new OrderController(),否则容器无法介入,会报错:Too few arguments to function... - 接口类型(如
LoggerInterface)需提前绑定实现类,否则容器不知道该注入谁。
手动注入依赖(不推荐,仅限特殊场景)
虽然构造器注入是首选,但某些情况下(如命令行类、事件监听器、旧代码迁移)你可能需要手动触发容器解析:
方式一:用 app() 全局辅助函数(最常用)
$controller = app(OrderController::class); // 容器自动解析所有构造参数,包括 OrderService 和 LoggerInterface
方式二:用 $this->app->make()(在服务提供者或容器上下文中)
$this->app->make(OrderController::class);
方式三:在方法内按需获取(非构造器,叫“方法注入”或“运行时注入”)
public function update(Request $request)
{
$paymentService = app(PaymentService::class);
return $paymentService->process($request->all());
}
✅ 适合条件性使用、非核心依赖;❌ 避免滥用,否则掩盖设计问题(该注入的依赖,别藏在方法里临时取)
接口绑定示例(让构造器能解析接口)
若 LoggerInterface 没绑定,上面构造器会失败。需在 AppServiceProvider@register() 中注册:
use App\Contracts\LoggerInterface;
use App\Services\FileLogger;
public function register()
{
$this->app->bind(LoggerInterface::class, FileLogger::class);
}
-
bind():每次请求都新建实例 -
singleton():整个请求生命周期只创建一次(适合数据库连接、缓存管理器等)
小结关键点
- 构造器注入靠容器自动完成,只需写类型提示,不用
new或app() - 手动注入用
app(ClassName::class),适用于非路由驱动的类实例化 - 接口必须显式绑定,否则容器无法知道用哪个实现
- 别在构造器里
new XxxService(),这会绕过容器,破坏 DI 机制
不复杂但容易忽略。











