如何使用PHP-YAML的自定义标签回调？

Question

根据官方文档，有一种方法可以提供回调对于自定义 YAML 标签：

mixed yaml_parse ( string $input [, int $pos = 0 [, int &$ndocs [, array $callbacks ]]] )

回调
YAML 节点的内容处理程序。 YAML 标签的关联数组 =>回调映射。

然而，似乎没有关于这个主题的其他文档，即使在扩展源中也是如此！

我创建了这个脚本作为测试：

<?php

$yaml =<<<YAML
---
prop: !custom val
YAML;

print_r(yaml_parse($yaml,0,$n,array(
  YAML_STR_TAG => function () {
    echo "YAML_STR_TAG\n";
    $args = func_get_args();
    print_r($args);
    return 'x';
  },
  '!custom' => function () {
    echo "!custom\n";
    $args = func_get_args();
    print_r($args);
    return 'y';
  }
)));

我得到了这个输出：

$ php yaml.php
YAML_STR_TAG
Array
(
    [0] => prop
    [1] => tag:yaml.org,2002:str
    [2] => 1
)
!custom
Array
(
    [0] => val
    [1] => !custom
    [2] => 1
)
Array
(
    [x] => y
)

从那里我可以看出几件事：

• 回调查找中使用的键是 PHP-YAML 的 预定义常量 或 YAML 源中使用的自定义标记，包括感叹号
• 中的每个键和地图被“标记”并且传递给匹配的回调，可能是因为根据 YAML 规范，密钥也可以是任何有效类型。
• 三个参数传递给回调：标签的“主题”、标签本身和一些数字，可能对应于 YAML_*_SCALAR_STYLE 常量。
• 回调的返回值替换了标记的数据结构

任何人都可以确认此函数的预期行为吗？

Answer 1

经过大量研究和测试，我找到了一些答案。

如扩展程序的单元测试，每个回调采用三个参数：

• 混合 $data - 标记的数据，已解析
• 字符串 $tag - 标签名称，根据官方 YAML 标签规范< /a>:
  
  
  如果没有定义标签前缀，
  • !custom 将扩展为 !custom
  • !custom 扩展为 prefixcustom，其中 prefix 由文档元数据 %TAG 定义！前缀。请注意，没有前导感叹号
  • !!preset 扩展为解析器定义的内部类型。请参阅 YAML_*_TAG 常量< /里>
  • !<逐字标记>扩展为verbatim-tag`。请注意，没有前导感叹号。
• 整数 $style - 使用的标量样式。请参阅 YAML_*_SCALAR_STYLE

常量回调应该返回一个混合值供解析器发出。