symfony扩展类（extension）是bundle实现配置加载与服务注册的核心，需继承extension类并实现getconfiguration()定义配置结构、load()注册服务；还支持prependextensioninterface和compilerpass进阶控制。
Symfony 扩展类（Extension）是 Bundle 实现配置加载与服务注册的核心，它让 Bundle 能响应应用的配置并动态注入服务、参数或修改容器定义。写好一个 Extension 类，关键在于结构正确、逻辑清晰、不破坏容器编译流程。
Extension 类的基本骨架
每个 Bundle 的 DependencyInjection/ 目录下通常包含一个继承自 Symfony\Component\DependencyInjection\Extension\Extension 的类，例如 AcmeDemoExtension。它必须实现两个核心方法：
-
getConfiguration()：返回一个Configuration实例，用于定义该 Bundle 支持的配置结构（YAML/PHP 配置项的层级、类型、默认值等） -
load()：接收解析后的配置数组和ContainerBuilder，在此完成服务注册、参数设置、条件加载等实际逻辑
配置定义：用 Configuration 类约束输入
配置不是自由文本，而是有明确 schema 的。你需要在 DependencyInjection/Configuration.php 中定义规则：
- 使用
TreeBuilder构建配置树，比如支持acme_demo: { enabled: true, timeout: 30 } - 为字段设置
isRequired()、defaultValue()、validate()等校验逻辑 - 支持数组、布尔、整数、枚举等多种类型，并可嵌套多层
- 示例中常见写法：
$rootNode->children()->booleanNode('enabled')->defaultTrue()->end()
服务加载：在 load() 中操作容器
load() 是 Extension 的执行中枢。这里你可以：
- 调用
$container->register()或$container->autowire()注册服务 - 使用
$container->setParameter()设置全局参数 - 根据配置开关决定是否加载某组服务（如
if ($config['enabled']) { ... }） - 加载外部 YAML 配置文件：
$loader = new YamlFileLoader($container, new FileLocator(__DIR__.'/../Resources/config')); $loader->load('services.yaml'); - 注意：不要在
load()中直接调用get()获取服务——此时容器尚未编译完成
进阶技巧：Prepend 和 CompilerPass 协同扩展
单纯靠 load() 有时不够灵活。更深层的控制需要配合：
-
PrependExtensionInterface：实现后可在其他 Bundle 加载前“预置”配置（例如自动覆盖
framework.session的某些选项） - CompilerPass：在容器编译后期介入，适合修改已注册的服务定义（如替换装饰器、按标签批量处理服务、注入表达式语言提供者）
- SecurityBundle、WebProfilerBundle 等官方 Bundle 大量使用 CompilerPass 来增强安全策略或性能数据收集
不复杂但容易忽略：Extension 类名必须与 Bundle 类名对应（如 AcmeDemoBundle → AcmeDemoExtension），且需在 Bundle::build() 中显式添加到容器，否则不会被自动发现。
