如何用Symfony Yaml组件将PHP数组转为带锚点的YAML？

问题背景 #

需要将PHP数组转换为包含YAML锚点（&options）和合并键（<<: *options）的配置文件，期望输出如下：

templates: &options
  option1:
    name: Template 1
    file: template1.img
  option2:
    name: Template 2
    file: template2.img
  option3:
    name: Template 3
    file: template3.img
pages:
  front:
    file: front.yaml
    <<: *options
  back:
    file: back.yaml
    <<: *options

对应的原始PHP数组为：

$bookCover = [
    "templates" => [
        "option1" => [
            "name" => "Template 1",
            "file" => "template1.img"
        ],
        "option2" => [
            "name" => "Template 2",
            "file" => "template2.img"
        ],
        "option3" => [
            "name" => "Template 3",
            "file" => "template3.img"
        ]
    ],
    "pages" => [
        "front" => [
            "file" => "front.yaml"
        ],
        "back" => [
            "file" => "back.yaml"
        ]
    ]
];

直接使用Yaml::dump()会将锚点和合并键识别为普通字符串键，得到不符合预期的输出：

templates: 
  '&options':
    option1:
      name: Template 1
      file: template1.img
    option2:
      name: Template 2
      file: template2.img
    option3:
      name: Template 3
      file: template3.img
pages:
  front:
    file: front.yaml
    '<<': '*options'
  back:
    file: back.yaml
    '<<': '*options'

解决方案 #

Symfony Yaml组件提供了专门的标签类来处理YAML的锚点和合并语法，无需手动正则修改，步骤如下：

1. 引入必要的类 #

use Symfony\Component\Yaml\Yaml;
use Symfony\Component\Yaml\Tag\AnchorTag;
use Symfony\Component\Yaml\Tag\MergeTag;

2. 修改PHP数组，添加锚点与合并标记 #

用AnchorTag包裹需要设置锚点的内容并命名，用MergeTag引用该锚点：

$bookCover = [
    "templates" => new AnchorTag([
        "option1" => [
            "name" => "Template 1",
            "file" => "template1.img"
        ],
        "option2" => [
            "name" => "Template 2",
            "file" => "template2.img"
        ],
        "option3" => [
            "name" => "Template 3",
            "file" => "template3.img"
        ]
    ], 'options'), // 锚点名称为options
    "pages" => [
        "front" => [
            "file" => "front.yaml",
            '<<' => new MergeTag('options') // 引用名为options的锚点
        ],
        "back" => [
            "file" => "back.yaml",
            '<<' => new MergeTag('options')
        ]
    ]
];

3. 生成YAML时开启标签解析 #

调用Yaml::dump()时传入Yaml::DUMP_TAGS选项，让组件识别自定义标签：

echo Yaml::dump($bookCover, 4, 2, Yaml::DUMP_TAGS);

执行后就能生成符合预期的YAML内容。

新手提问技巧建议 #

• 精准描述核心需求：直接点明“用Symfony Yaml组件生成带锚点和合并键的YAML”，而非模糊的“PHP转YAML有问题”
• 提供完整上下文：包含使用的组件版本、尝试的代码、实际输出与期望输出的对比，帮助他人快速定位问题
• 说明排除的方案：比如明确提到“不想用正则手动处理”，避免收到重复的无效建议
• 简化问题场景：去掉无关业务逻辑，只保留能复现问题的最小代码示例，降低理解成本

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