如何在Symfony配置中实现带随机键的布尔节点数组及默认值？

问题描述 #

你期望的YAML配置结构：

app:
    integrations:
        some: true
        random: true
        options: true
        user_can_make_these_up: true

编译后要包含默认值mykey: true和myotherkey: false，最终输出平级数组：

[
    mykey => true,
    myotherkey => false,
    some => true,
    random => true,
    options => true,
    user_can_make_these_up => true,
]

你编写的配置节点代码：

$rootNode
    ->children()
        ->arrayNode('integrations')
            ->ignoreExtraKeys()
            ->addDefaultsIfNotSet()
            ->children()
                ->booleanNode('mykey')->defaultTrue()->end()
            ->end()
        ->end()
    ->end();

运行时报错：Unrecognized option "mykey" under "app". Available option is "integrations".

错误原因 #

1. 配置结构不匹配：你在代码里把mykey定义为integrations的子节点，但实际YAML配置中可能把mykey直接写在了app节点下，导致系统识别不到该选项。
2. 最终结构逻辑缺失：你的代码没有处理myotherkey的默认值，也没实现把integrations下的自定义键与默认键合并为平级数组的逻辑。

解决方案 #

根据你的需求，分两种场景处理：

场景1：保持YAML中app.integrations的层级结构 #

先修正配置节点代码，把两个默认键都放在integrations下，并允许自定义额外键：

$rootNode
    ->children()
        ->arrayNode('integrations')
            ->ignoreExtraKeys(false) // 允许用户添加任意自定义键
            ->addDefaultsIfNotSet()
            ->children()
                ->booleanNode('mykey')->defaultTrue()->end()
                ->booleanNode('myotherkey')->defaultFalse()->end()
            ->end()
        ->end()
    ->end();

然后在配置加载逻辑（比如Extension类的load方法）中，提取integrations的内容作为最终平级配置：

public function load(array $configs, ContainerBuilder $container)
{
    $configuration = new Configuration();
    $processedConfig = $this->processConfiguration($configuration, $configs);
    
    // 提取integrations下的所有键，得到你期望的平级数组
    $finalConfig = $processedConfig['integrations'];
    
    // 将最终配置注入容器（示例）
    $container->setParameter('app.integrations_config', $finalConfig);
}

场景2：直接在YAML的app节点下写所有键 #

如果不需要integrations层级，直接把根节点定义为允许自定义键的数组节点：

$rootNode
    ->ignoreExtraKeys(false) // 允许任意自定义键
    ->addDefaultsIfNotSet()
    ->children()
        ->booleanNode('mykey')->defaultTrue()->end()
        ->booleanNode('myotherkey')->defaultFalse()->end()
    ->end();

对应的YAML配置简化为：

app:
    some: true
    random: true
    options: true
    user_can_make_these_up: true

编译后直接生成你期望的平级数组。

内容的提问来源于stack exchange，提问作者Johnson55