Twig - HackMD

Twig === 特色介紹 --- Twig 是一種模板化語言，它主要用於輸出 HTML。 ![](https://i.imgur.com/K2p0oql.png) 它是一個獨立的 plug-in，可以輕鬆整合到任何 PHP 專案中。 - 快速 - 將模板編譯為簡單優化的 PHP 代碼。與常規 PHP 程式碼相比，減少資源浪費。 - 安全 - 也一個sandbox模式來評估不受信任的程式碼，允許twig作為應用程式的模板語言，使用者可以在其中修改模板設計 - 靈活 - 支援靈活的parser 和lexer，允許開發者自己定義tag和filters，和建立自己的DSL. ``` Filter: users | length >10 Tag: list all ``` 模板只是一個文字文件。它可以生成任何基於文字的格式(HTML、XML、CSV)。它没有特定的副檔名.html或.xml。模板包含變量或表達式，當模板被評估時，這些變量或表達式被值所替代，而標籤則控制模版的邏輯層以下是簡單的模板範例 ```clike= <!DOCTYPE html> <html> <head> <title>My Webpage</title> </head> <body> <ul id="navigation"> {% for item in navigation %} <li><a href="{{ item.href }}">{{ item.caption }}</a></li> {% endfor %} </ul> <h1>My Webpage</h1> {{ a_variable }} </body> </html> ``` 除了常見的html標籤外可以看到```{%...%}```和```{{...}}```分隔符號 ```c= {%...%} "以此開頭通常用於執行條件判斷等語句" {% for %}{% endfor %} {{...}} "此開頭則為表達式的結果" ``` 與傳統PHP比較 --- - 簡潔：PHP 語言很冗長，在輸出轉譯方面變得非常冗長： ```php= <?php echo $var ?> <?php echo htmlspecialchars($var, ENT_QUOTES, 'UTF-8') ?> ``` 相比之下，Twig 的語法非常簡潔，這使得模板更具可讀性： ```php= {{ var }} {{ var|escape }} {{ var|e }} {# shortcut to escape a variable #} ``` - 快捷方式 - 在迭代空矩陣時時顯示預設文字： ```php= {% for user in users %} * {{ user.name }} {% else %} No users have been found. {% endfor %} ``` - 多功能：輕鬆構建強大模板所需的一切：多重繼承、block、自動輸出轉義等等： ```php= {% extends "layout.html" %} {% block content %} Content of the page... {% endblock %} ``` - 易於學習：語法易於學習並且已經過優化，使網頁設計師可以沒有困擾的快速完成工作。 - 可擴展性：Twig 足夠靈活，可以滿足您的所有需求，即使是最複雜的需求。得益於開放式架構，您可以實現自己的語言結構（標籤、過濾器、函數，甚至運算符）來創建您自己的 DSL。 - 單元測試：Twig 是完全單元測試的。該庫是穩定的，可以在大型項目中使用。有文檔：Twig 有完整的文檔，有專門的在線書籍，當然還有完整的 API 文檔。 - 安全：在安全方面，Twig 有一些獨特的功能： - 自動輸出轉譯：為了安全起見，您可以全局或為代碼塊啟用自動輸出轉義 - snadbox：Twig 可以評估sandbox環境中的任何模板，在sandbox環境中，用戶可以訪問開發人員定義的一組有限的tag、filter和object method。可以為某些模板全局或本地啟用沙盒： ```php= //轉譯 {% autoescape "html" %} {{ var }} {{ var|raw }} {# var won't be escaped #} {{ var|escape }} {# var won't be doubled-escaped #} {% endautoescape %} ``` ```php= //sandbox {{ include('page.html', sandboxed = true) }} ``` - 清除錯誤消息：每當您在模板中遇到語法問題時，Twig 都會輸出一條有幫助的訊息，其中包含文件名和出現bug的行號。方便debug。 - 快速：Twig 的目標之一是盡可能快。為了盡可能獲得最佳速度，Twig 將模板編譯為簡單優化的 PHP 程式碼。與常規 PHP 程式碼相比，資源花費降至最低。

Syntax	Example	Reference
# Header	Header	基本排版
- Unordered List	Unordered List
1. Ordered List	Ordered List
- [ ] Todo List	Todo List
> Blockquote	Blockquote
Bold font	Bold font
Italics font	Italics font
~~Strikethrough~~	~~Strikethrough~~
19^th^	19^th
H~2~O	H₂O
++Inserted text++	Inserted text
==Marked text==	Marked text
[link text](https:// "title")	Link
![image alt](https:// "title")	Image
`Code`	`Code`	在筆記中貼入程式碼
```javascript var i = 0; ```	`var i = 0;`
:smile:		Emoji list
{%youtube youtube_id %}	Externals
$L^aT_eX$	L^aT_eX
:::info This is a alert area. :::	This is a alert area.