使用 PHP 解析 YAML Front Matter

Question

我有 YAML Front Matter 我想用 PHP 解析：

---
title = A nice title goes here
tags = tag1 tag2 tag3
---
This is the content of this entry...
Line2
Line3

我知道它是关于某种 Ruby gem 的，但我想在 PHP 中使用它来创建一个用户友好的平面文件博客引擎。

我还有一个名为 Phrozn 的项目的片段。也许你们可以方便地看到它，以便尽可能地帮助我解决问题。

private function parse()
{
    if (isset($this->template, $this->frontMatter)) {
        return $this;
    }

    $source = $this->readSourceFile();

    $parts = preg_split('/[\n]*[-]{3}[\n]/', $source, 2);
    if (count($parts) === 2) {
        $this->frontMatter = Yaml::load($parts[0]);
        $this->template = trim($parts[1]);
    } else {
        $this->frontMatter = null;
        $this->template = trim($source);
    }

    return $this;
}

Answer 1

我认为你的问题是你试图将具有三个部分的东西分成两个部分。如果将第三个参数删除到 preg_split，您将得到一个包含三个元素的数组。第一部分（当由 --- 分隔时）：

---
title = A nice title goes here
tags = tag1 tag2 tag3
---
This is the content of this entry...
Line2
Line3

为空，第二部分是 YAML，第三部分是内容。试试这个：

$parts = preg_split('/[\n]*[-]{3}[\n]/', $source, 3);

还有一个实时测试用例： http://ideone.com/LYLxZ

如果你想匹配 Phrozn似乎正在做，那么你的输入将如下所示：

title = A nice title goes here
tags = tag1 tag2 tag3
---
This is the content of this entry...
Line2
Line3

你的 PHP 将是这样的：

$parts = preg_split('/[\n]*[-]{3}[\n]/', $source, 2);

以及此版本的实时测试用例： http://ideone.com/a9a6C

Answer 2

我遇到了同样的问题，并且对未经测试的正则表达式和可用的稀有软件包非常不满意。

我写了一个库（Composer、TDD、PSR-4）来处理这个问题。该库还处理解析 YAML 和 Markdown：FrontYAML< /strong>

YAML 和 Markdown 解析器可以被覆盖。默认情况下，使用 Symfony YAML 和 Parsedown。

Answer 3

我是这样做的：

// $string contains the full file.

$split = preg_split("/[\n]*[-]{3}[\n]/", $string, 3, PREG_SPLIT_NO_EMPTY);
try {
  // Strip extra, non-indentation, whitespace from beginning of lines
  $i = 0; $yfm = "";
  while ($split[0][$i] == " ") {$i++;}
  foreach(preg_split("/((\r?\n)|(\r\n?))/", $split[0]) as $line){
    $yfm .= substr($line, $i) . "\n";
  }
  // Using symfony's YAML parser
  $data = sfYaml::load($yfm);
} catch(InvalidArgumentException $e) {
  // This is not YAML
}

它删除了可能导致解析器出错的无关缩进，并将所有换行符转换为 ，无论它们是 Win (CRLF)、Nix (LF) 还是 Mac (CR)” \n"。