Bundle配置通过DependencyInjection扩展类与Configuration类协同完成：Extension类实现load()和getConfiguration()方法处理配置，Configuration类用TreeBuilder定义校验规则，配置文件位于config/packages/，按PSR-4规范命名和加载。
Bundle 配置不是写在 Bundle 类里，而是通过 DependencyInjection 扩展类 + Configuration 类 两部分协同完成的。核心逻辑是：配置文件（YAML/XML/PHP）中的内容，经由 Configuration 校验后，交由 Extension 的 load() 方法转化为服务定义和运行时行为。
1. 必须实现 Extension 类
每个可配置的 Bundle 都要提供一个继承自 SymfonyComponentDependencyInjectionExtensionExtension 的类，通常放在 src/YourBundle/DependencyInjection/YourBundleExtension.php：
- 类名必须与 Bundle 名匹配，如
MyBundleExtension对应MyBundle - 必须实现
load()方法：在这里读取已解析的配置数组，注册服务、参数或修改容器 - 必须实现
getConfiguration()方法：返回一个Configuration实例，用于定义合法配置结构 - 如果 Bundle 支持预加载其他 Bundle 的配置（比如覆盖 FrameworkBundle 默认值），可实现
PrependExtensionInterface
2. 必须定义 Configuration 类
该类负责声明“哪些配置项允许存在、类型是什么、是否必填、默认值是多少”。它使用 SymfonyComponentConfigDefinitionBuilderTreeBuilder 构建校验规则：
- 根节点名通常与 Bundle 名小写一致，如
my_bundle（对应 YAML 中的my_bundle:） - 用
arrayNode()定义配置块，scalarNode()定义字符串/布尔/数字字段，enumNode()限定可选值 - 用
defaultValue()设置默认值，isRequired()标记必填，validate()写自定义校验逻辑 - 配置最终会被 Symfony 解析成 PHP 数组，传给
Extension::load()
3. 配置文件放在哪里？怎么被加载？
用户项目中实际写的配置，放在 config/packages/your_bundle.yaml（或 xml/php）。Symfony 启动时会自动扫描所有启用 Bundle 的 DependencyInjection 目录，找到对应的 Extension 类并触发加载流程：
- 内核收集所有 Bundle 的配置片段（按顺序合并）
- 调用每个 Bundle 的
Configuration进行结构校验和标准化 - 将处理后的数组传入
Extension::load() - 你在
load()里用$container->setDefinition()或$container->setParameter()注入配置结果
4. 注意命名空间与自动发现
Bundle 类、Extension 类、Configuration 类必须在 PSR-4 声明的路径下，且命名空间严格匹配：
- Bundle 类：命名空间如
MyCompanyMyBundle，文件路径src/MyBundle.php - Extension 类：命名空间同 Bundle，路径
src/DependencyInjection/MyBundleExtension.php - Configuration 类：路径
src/DependencyInjection/Configuration.php，类名固定为Configuration - composer.json 中
"autoload": {"psr-4": {"MyCompany\MyBundle\": "src/"}}必须覆盖全部类
