Laravel 服务容器与依赖注入：从 Facade 到接口绑定的工程化落地

容器是 Laravel 的心脏

Laravel 的服务容器是一个强大的依赖注入容器，负责实例化类并自动解析它们的依赖。理解它，才能写出可测试、可替换、可扩展的业务代码，而不是到处 new 具体实现。

自动解析：构造函数注入

只要类型提示写清楚，容器会自动把依赖实例塞进构造函数。这是日常最常用的方式。

namespace App\Services;

use App\Repositories\UserRepository;

class UserService
{
    public function __construct(
        private UserRepository $users
    ) {}

    public function listActive()
    {
        return $this->users->where('active', 1)->get();
    }
}

// 在控制器里直接类型提示，容器自动解析
public function index(UserService $service)
{
    return response()->json($service->listActive());
}

绑定接口与实现：面向契约编程

业务依赖接口而非具体类，容器在服务提供者里把接口绑定到实现。切换实现（如换缓存驱动、换第三方 SDK）只改一行绑定。

// app/Providers/AppServiceProvider.php
use App\Contracts\PaymentGateway;
use App\Services\StripePayment;

public function register(): void
{
    $this->app->bind(PaymentGateway::class, StripePayment::class);
}

// 使用时只依赖接口
public function pay(PaymentGateway $gateway, Order $order)
{
    return $gateway->charge($order->amount);
}

bind 与 singleton 的区别

bind 每次解析都新建实例，singleton 在容器内只实例化一次并在后续复用。无状态的服务用 singleton 省开销，有状态或需要独立实例的用 bind。

$this->app->singleton(CacheManager::class, fn () => new CacheManager());
$this->app->bind(ReportBuilder::class, fn () => new ReportBuilder());

Facade 的本质

Facade 不是静态类，而是容器里真实实例的静态代理。它提供简洁写法，但底层仍走容器解析。测试时用 fake() 能轻松替换实现，不必纠结"该不该用 Facade"。

// 写法
use Illuminate\Support\Facades\Cache;
Cache::put('key', 'value', 60);

// 测试中替换为假实现
Cache::shouldReceive('get')->andReturn('fake');

实践建议

• 业务代码依赖接口，绑定放到 ServiceProvider，别在业务里写具体类名。
• 有状态的、每次要全新的对象用 bind；全局共享的用 singleton。
• 单元测试用容器或 fake 替换依赖，而不是连真实数据库。
• 循环依赖（A 依赖 B，B 又依赖 A）说明设计有问题，先用接口拆分解耦。