# 模板解析器 ### 介紹 十月使用幾種標準來處理標記，模板和配置。每個人都經過精心選擇，以發揮自己的作用，使您的開發過程和學習曲線盡可能簡單。例如，[在主題中找到](https://octobercms.com/docs/cms/themes)的[對象](https://octobercms.com/docs/cms/themes)在其模板結構中使用[Twig](https://octobercms.com/docs/services/parser#twig-parser)和[INI格式](https://octobercms.com/docs/services/parser#ini-parser)。每個解析器將在下面更詳細地描述。 ### [](https://octobercms.com/docs/services/parser#markdown-parser)Markdown解析器 Markdown允許您編寫易于閱讀和易于編寫的純文本格式，然后將其轉換為HTML。該`Markdown`外觀用于解析Markdown語法，并且基于[GitHub風格的markdown](https://help.github.com/articles/github-flavored-markdown/)。減價的一些快速示例： ~~~ This text is **bold**, this text is *italic*, this text is ~~crossed out~~. # The largest heading (an <h1> tag) ## The second largest heading (an <h2> tag) ... ###### The 6th largest heading (an <h6> tag) ~~~ 使用該`Markdown::parse`方法將Markdown呈現為HTML： ~~~ $html = Markdown::parse($markdown); ~~~ 您也可以使用`|md`過濾器來[解析前端標記中的Markdown](https://octobercms.com/docs/markup/filter-md)。 ~~~ {{ '**Text** is bold.'|md }} ~~~ ### [](https://octobercms.com/docs/services/parser#twig-parser)樹枝模板解析器 Twig是一個簡單但功能強大的模板引擎，可將HTML模板解析為優化的PHP代碼，它是[前端標記](https://octobercms.com/docs/markup)，[查看內容](https://octobercms.com/docs/services/response-view#views)和[郵件內容的](https://octobercms.com/docs/services/mail#message-content)背后驅動力。 該`Twig`門面被用來解析嫩枝語法，您可以使用該`Twig::parse`方法來呈現嫩枝為HTML。 ~~~ $html = Twig::parse($twig); ~~~ 第二個參數可用于將變量傳遞到Twig標記。 ~~~ $html = Twig::parse($twig, ['foo' => 'bar']); ~~~ Twig解析器可以擴展為通過[插件注冊文件](https://octobercms.com/docs/plugin/registration#extending-twig)注冊自定義功能。 ### [](https://octobercms.com/docs/services/parser#bracket-parser)括號解析器 October還附帶了一個簡單的括號模板解析器，以替代Twig解析器，該解析器當前用于將變量傳遞到[主題內容塊](https://octobercms.com/docs/cms/content#content-variables)。該引擎呈現HTML的速度更快，并且被設計為更適合非技術用戶。該解析器沒有外觀，因此`October\Rain\Parse\Bracket`應將完全限定的類與該`parse`方法一起使用。 ~~~ use October\Rain\Parse\Bracket; $html = Bracket::parse($content, ['foo' => 'bar']); ~~~ 該語法使用單個*大括號*來呈現變量： ~~~ <p>Hello there, {foo}</p> ~~~ 您還可以傳遞對象數組以將其解析為變量。 ~~~ $html = Template::parse($content, ['likes' => [ ['name' => 'Dogs'], ['name' => 'Fishing'], ['name' => 'Golf'] ]]); ~~~ 可以使用以下語法對數組進行迭代： ~~~ <ul> {likes} <li>{name}</li> {/likes} </ul> ~~~ ### [](https://octobercms.com/docs/services/parser#yaml-parser)YAML配置解析器 YAML（“ YAML不是標記語言”）是一種配置格式，與Markdown相似，它被設計為易于閱讀和易于編寫的格式，可以轉換為PHP數組。十月的后端開發幾乎在任何地方都使用它，例如[表單字段](https://octobercms.com/docs/backend/forms#form-fields)和[列表列](https://octobercms.com/docs/backend/lists##list-columns)定義。一些YAML的示例： ~~~ receipt: Acme Purchase Invoice date: 2015-10-02 user: name: Joe surname: Blogs ~~~ 該`Yaml`門面被用來解析YAML和使用`Yaml::parse`方法來呈現YAML的PHP數組： ~~~ $array = Yaml::parse($yamlString); ~~~ 使用該`parseFile`方法來解析文件的內容： ~~~ $array = Yaml::parseFile($filePath); ~~~ 解析器還支持反向操作，從PHP數組輸出YAML格式。您可以`render`為此使用方法： ~~~ $yamlString = Yaml::render($array); ~~~ ### [](https://octobercms.com/docs/services/parser#ini-parser)初始化（INI）配置解析器 INI文件格式是定義簡單配置文件的標準，通常由[主題模板內](https://octobercms.com/docs/cms/components)的[組件](https://octobercms.com/docs/cms/components)使用。它可以被認為是YAML格式的表親，盡管它與YAML不同，但它非常簡單，對拼寫錯誤不敏感并且不依賴縮進。它支持帶有部分的基本鍵值對，例如： ~~~ receipt = "Acme Purchase Invoice" date = "2015-10-02" [user] name = "Joe" surname = "Blogs" ~~~ 該`Ini`門面被用來解析INI和使用`Ini::parse`方法來呈現INI到PHP數組： ~~~ $array = Ini::parse($iniString); ~~~ 使用該`parseFile`方法來解析文件的內容： ~~~ $array = Ini::parseFile($filePath); ~~~ 解析器還支持反向操作，從PHP數組輸出INI格式。您可以`render`為此使用方法： ~~~ $iniString = Ini::render($array); ~~~ ### [](https://octobercms.com/docs/services/parser#october-ini)十月風味INI 傳統上，PHP函數使用的INI解析器`parse_ini_string`僅限于3級深度的數組。例如： ~~~ level1Value = "foo" level1Array[] = "bar" [level1Object] level2Value = "hello" level2Array[] = "world" level2Object[level3Value] = "stop here" ~~~ October通過使用*October風格的INI*擴展了此功能，以允許無限深度的數組（受HTML表單語法的啟發）。在上面的示例之后，支持以下語法： ~~~ [level1Object] level2Object[level3Array][] = "Yay!" level2Object[level3Object][level4Value] = "Yay!" level2Object[level3Object][level4Array][] = "Yay!" level2Object[level3Object][level4Object][level5Value] = "Yay!" ; ... to infinity and beyond! ~~~