PHP处理YAML时，能否仅加载文件内的指定独立文档？

当然可以，不管用PHP原生的YAML扩展，还是第三方YAML处理库，都能实现只加载目标文档（比如你示例中的#user文档），下面分场景给出具体实现方式：

一、使用PHP原生YAML扩展 #

如果你的PHP环境已经安装了YAML扩展（可通过php -m查看是否存在yaml模块），可以直接用扩展提供的函数快速处理：

1. 已知目标文档的索引 #

你的示例YAML里，#settings是第1个文档（索引0），#user是第2个文档（索引1），直接指定索引加载即可：

// 检查YAML扩展是否存在
if (!extension_loaded('yaml')) {
    die('请先安装PHP YAML扩展');
}

$yamlPath = '你的YAML文件路径';
$docCount = 0;

// 加载索引为1的文档（即#user对应的内容）
$userData = yaml_parse_file($yamlPath, 1, $docCount);

if ($userData !== false) {
    // 处理用户文档数据
    var_dump($userData);
} else {
    echo '加载YAML文档失败';
}

2. 通过文档开头的注释标识加载 #

如果不知道索引，只能通过#user这个注释来识别文档，需要先读取文件内容分割文档，再匹配注释后解析：

$yamlContent = file_get_contents('你的YAML文件路径');
// 按---分割多文档，同时保留注释部分
$docSegments = preg_split('/^\-\-\-(.*)$/m', $yamlContent, -1, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY);

$userData = null;
// 每两个元素为一组：注释内容 + 文档内容
foreach (array_chunk($docSegments, 2) as [$comment, $docContent]) {
    if (trim($comment) === '#user') {
        $userData = yaml_parse(trim($docContent));
        break;
    }
}

if ($userData) {
    var_dump($userData);
}

二、使用第三方YAML库（以Symfony Yaml为例） #

如果你的环境没装原生扩展，推荐用Symfony的Yaml组件，兼容性更强，先通过Composer安装：

composer require symfony/yaml

1. 已知索引加载 #

use Symfony\Component\Yaml\Yaml;

$yamlPath = '你的YAML文件路径';
// 解析所有文档
$allDocs = Yaml::parseFile($yamlPath, Yaml::PARSE_DOCUMENTS);

// 直接取索引为1的#user文档
$userData = $allDocs[1];
var_dump($userData);

2. 通过注释标识加载 #

use Symfony\Component\Yaml\Yaml;

$yamlContent = file_get_contents('你的YAML文件路径');
$docSegments = preg_split('/^\-\-\-(.*)$/m', $yamlContent, -1, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY);

$userData = null;
foreach (array_chunk($docSegments, 2) as [$comment, $docContent]) {
    if (trim($comment) === '#user') {
        $userData = Yaml::parse(trim($docContent));
        break;
    }
}

var_dump($userData);

注意：YAML文档开头---后面的注释（比如#settings）不会被解析到数据结构里，所以如果要通过这个注释识别文档，必须手动处理文件内容分割匹配。

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