interfaces-and-autowiring

接口与自动装配（Symfony）

适用场景

• 服务依赖于具体类，且必须能够替换，或在测试中替换。
• 某个接口有多个实现，必须注入正确的实现。
• 在现有服务周围添加横切行为（日志记录、缓存、重试）。
• 注入标量、参数、环境变量，或所有带有某个标签的服务。
• 自动装配失败，提示“cannot autowire”或类型不明确。

默认工作流

1. 为消费者实际需要的功能提取一个专注的接口。
2. 如果只有一个实现，就让自动装配绑定该接口。
3. 如果有多个实现，则通过命名别名和 #[Target] 为每个消费者选择一个实现。
4. 使用 #[AsDecorator] 为服务添加行为，而不是编辑或扩展该服务。
5. 使用 #[Autowire] 注入标量，使用 #[AutowireIterator] 注入带标签的集合。
6. 对涉及的每种类型运行 debug:autowiring，确认结果。

防护原则

• 使用构造函数注入和 private readonly 依赖；不使用 setter 注入，也不访问容器。
• 保持接口精简：每个接口只满足一种消费者需求。
• 默认将服务设为 final，通过装饰服务而非继承来扩展行为。
• 只有当某些执行路径会跳过昂贵依赖时，才使用惰性服务或服务闭包。

渐进式披露

• 使用此文件了解执行方式和风险控制。
• 需要深入了解实现细节时，再打开参考资料。

输出约定

• 接口，以及用于选择各个实现的绑定或别名。
• 装饰器或带标签的集合及其优先级。
• 涉及类型的 debug:autowiring 输出。

参考资料

• reference.md