国产,欧美,日韩综合久久,caoporm国产精品视频免费

日期和date_modify

format

striptags

escape

首頁(yè)

後端開發(fā)

php教程

樹枝 - 最受歡迎的獨(dú)立PHP模板引擎

Lisa Kudrow

Feb 09, 2025 am 09:07 AM

Twig - the Most Popular Stand-Alone PHP Template Engine

Twig：一款流行的PHP模板引擎

Twig是由Sensio Labs開發(fā)的PHP流行模板引擎，它簡(jiǎn)化了PHP代碼，並增加了安全和調(diào)試等功能。 Twig同時(shí)作用於項(xiàng)目的frontend和backend，可以從兩個(gè)角度來(lái)看：模板設(shè)計(jì)師的Twig和開發(fā)者的Twig。 Twig使用名為Environment的核心對(duì)象來(lái)存儲(chǔ)配置、擴(kuò)展，並從文件系統(tǒng)或其他位置加載模板。 Twig支持嵌套模板（塊），避免模板中元素重複，並能緩存編譯後的模板以加快後續(xù)請(qǐng)求速度。 Twig支持條件語(yǔ)句、循環(huán)和過(guò)濾器來(lái)控制模板中信息的顯示，並提供調(diào)試功能來(lái)轉(zhuǎn)儲(chǔ)模板變量的所有信息。

本文由Wern Ancheta同行評(píng)審。感謝所有SitePoint的同行評(píng)審員，使SitePoint的內(nèi)容達(dá)到最佳狀態(tài)!

Twig是PHP的模板引擎。但是，PHP本身不是模板引擎嗎？是的，也不是！儘管PHP最初是作為模板引擎，但它的發(fā)展並非如此，雖然我們?nèi)匀豢梢詫⑵溆米髂０逡妫?qǐng)問(wèn)您更喜歡哪個(gè)版本的“Hello world”：

<?php echo "<p> Hello " . $name . "</p>"; ?>

還是

<p>Hello {{ name }}</p>

PHP是一種冗長(zhǎng)的語(yǔ)言，在嘗試輸出HTML內(nèi)容時(shí)，這種冗長(zhǎng)性會(huì)被放大?，F(xiàn)代模板系統(tǒng)將消除部分冗長(zhǎng)性，並在其之上增加相當(dāng)多的功能。諸如安全和調(diào)試功能之類的特性是現(xiàn)代模板引擎的支柱。今天，我們將重點(diǎn)介紹Twig。

Twig - the Most Popular Stand-Alone PHP Template Engine

Twig是由Sensio Labs（Blackfire和Symfony的開發(fā)公司）創(chuàng)建的模板引擎。讓我們來(lái)看看它的主要優(yōu)勢(shì)以及如何在項(xiàng)目中使用它。

安裝

安裝Twig有兩種方法。我們可以使用其網(wǎng)站上提供的tar包，或者像我們一直做的那樣，使用Composer。

composer require twig/twig

我們假設(shè)您正在運(yùn)行已設(shè)置PHP並全局安裝Composer的環(huán)境。最好的方法是使用Homestead Improved——它可以讓您在5分鐘內(nèi)在與我們使用的完全相同的機(jī)器上開始使用，這樣我們就能在同一頁(yè)面上。如果您想了解有關(guān)PHP環(huán)境的更多信息，我們這裡有一本關(guān)於此的優(yōu)秀付費(fèi)書籍可供購(gòu)買。

在我們繼續(xù)之前，我們需要先澄清一些事情。作為模板引擎，Twig同時(shí)作用於項(xiàng)目的frontend和backend。因此，我們可以從兩個(gè)不同的角度來(lái)看待Twig：模板設(shè)計(jì)師的Twig和開發(fā)者的Twig。一方面，我們準(zhǔn)備所有需要的數(shù)據(jù)；另一方面，我們呈現(xiàn)所有這些數(shù)據(jù)。

基本用法

為了舉例說(shuō)明Twig的基本用法，讓我們創(chuàng)建一個(gè)簡(jiǎn)單的項(xiàng)目。首先，我們需要引導(dǎo)Twig。讓我們創(chuàng)建一個(gè)包含以下內(nèi)容的bootstrap.php文件：

<?php echo "<p> Hello " . $name . "</p>"; ?>

Twig使用名為Environment的核心對(duì)象。此類的實(shí)例用於存儲(chǔ)配置、擴(kuò)展，並從文件系統(tǒng)或其他位置加載模板。在我們的Twig實(shí)例引導(dǎo)後，我們可以繼續(xù)創(chuàng)建一個(gè)index.php文件，在其中加載一些數(shù)據(jù)並將其傳遞給Twig模板。

<p>Hello {{ name }}</p>

這是一個(gè)簡(jiǎn)單的示例；我們正在創(chuàng)建一個(gè)包含產(chǎn)品的數(shù)組，例如我們的機(jī)械鍵盤，我們可以在模板中使用它。然後，我們使用render()方法，它接受模板名稱（這是我們之前定義的模板文件夾中的一個(gè)文件）以及我們要傳遞給模板的數(shù)據(jù)。為了完成我們的示例，讓我們進(jìn)入我們的/templates文件夾並創(chuàng)建一個(gè)index.html文件。首先，讓我們看看模板本身。

composer require twig/twig

在瀏覽器中打開index.php（訪問(wèn)localhost或homestead.app，具體取決於您如何設(shè)置主機(jī)和服務(wù)器）現(xiàn)在應(yīng)該會(huì)顯示以下屏幕：

Twig - the Most Popular Stand-Alone PHP Template Engine

但是讓我們回到並仔細(xì)看看我們的模板代碼。有兩種類型的分隔符：{{ ... }}用於打印表達(dá)式或操作的結(jié)果，而{% ... %}用於執(zhí)行諸如條件語(yǔ)句和循環(huán)之類的語(yǔ)句。這些分隔符是Twig的主要語(yǔ)言結(jié)構(gòu)，Twig使用它們來(lái)“告知”模板它必須呈現(xiàn)Twig元素。

(以下內(nèi)容與原文類似，但做了部分語(yǔ)句調(diào)整和段落劃分，並保持了圖片位置不變)

佈局

為了避免在模板中重複元素（如頁(yè)眉和頁(yè)腳），Twig允許我們將模板嵌套在模板中，這些被稱為塊。為了舉例說(shuō)明這一點(diǎn)，讓我們將實(shí)際內(nèi)容與示例中的HTML定義分開。讓我們創(chuàng)建一個(gè)新的HTML文件並將其命名為layout.html：

<?php
// 加載我們的自動(dòng)加載器
require_once __DIR__.'/vendor/autoload.php';

// 指定我們的Twig模板位置
$loader = new Twig_Loader_Filesystem(__DIR__.'/templates');

// 實(shí)例化我們的Twig
$twig = new Twig_Environment($loader);

我們創(chuàng)建了一個(gè)名為content的塊。我們的意思是，每個(gè)從layout.html擴(kuò)展的模板都可以實(shí)現(xiàn)一個(gè)content塊，該塊將顯示在該位置。這樣，我們可以多次重用佈局而無(wú)需重寫它。在本例中，index.html文件現(xiàn)在如下所示：

<?php
require_once __DIR__.'/bootstrap.php';

// 創(chuàng)建產(chǎn)品列表
$products = [
    [
        'name'          => 'Notebook',
        'description'   => 'Core i7',
        'value'         =>  800.00,
        'date_register' => '2017-06-22',
    ],
    [
        'name'          => 'Mouse',
        'description'   => 'Razer',
        'value'         =>  125.00,
        'date_register' => '2017-10-25',
    ],
    [
        'name'          => 'Keyboard',
        'description'   => 'Mechanical Keyboard',
        'value'         =>  250.00,
        'date_register' => '2017-06-23',
    ],
];

// 渲染我們的視圖
echo $twig->render('index.html', ['products' => $products] );

Twig還允許我們只渲染單個(gè)塊。為此，我們需要首先加載模板，然後渲染塊。

<!DOCTYPE html>
<html lang="pt-BR">
    <head>
        <meta charset="UTF-8">
        <title>Twig Example</title>
    </head>
    <body>
    <table> border="1" style="width: 80%;">
        <thead>
            <tr>
                <td>Product</td>
                <td>Description</td>
                <td>Value</td>
                <td>Date</td>
            </tr>
        </thead>
        <tbody>
            {% for product in products %}
                <tr>
                    <td>{{ product.name }}</td>
                    <td>{{ product.description }}</td>
                    <td>{{ product.value }}</td>
                    <td>{{ product.date_register|date("m/d/Y") }}</td>
                </tr>
            {% endfor %}
        </tbody>
    </table>
    </body>
</html>

此時(shí)，我們?nèi)匀粨碛邢嗤捻?yè)面，但我們通過(guò)分離上下文塊來(lái)降低了它的複雜性。

緩存

Environment對(duì)像不僅可以用於加載模板。如果我們使用關(guān)聯(lián)目錄的cache選項(xiàng)傳遞，Twig將緩存編譯後的模板，從而避免在後續(xù)請(qǐng)求中解析模板。編譯後的模板將存儲(chǔ)在我們提供的目錄中。請(qǐng)注意，這是編譯模板的緩存，而不是已評(píng)估的模板的緩存。這意味著Twig將解析、編譯並保存模板文件。所有後續(xù)請(qǐng)求仍然需要評(píng)估模板，但第一步已經(jīng)為您完成。讓我們通過(guò)編輯bootstrap.php文件來(lái)緩存示例中的模板：

<?php echo "<p> Hello " . $name . "</p>"; ?>

(以下內(nèi)容與原文類似，但做了部分語(yǔ)句調(diào)整和段落劃分，並保持了圖片位置不變)

循環(huán)

在我們的示例中，我們已經(jīng)看到瞭如何使用Twig進(jìn)行循環(huán)。基本上，我們使用for標(biāo)籤並為指定數(shù)組中的每個(gè)元素分配一個(gè)別名。在本例中，我們?yōu)?code>products數(shù)組分配了別名product。之後，我們可以使用.運(yùn)算符訪問(wèn)每個(gè)數(shù)組元素中的所有屬性。我們使用endfor標(biāo)籤來(lái)指示循環(huán)的結(jié)束。我們還可以使用..運(yùn)算符循環(huán)遍歷數(shù)字或字母。如下所示：

<p>Hello {{ name }}</p>

或字母：

composer require twig/twig

此運(yùn)算符只是range函數(shù)的語(yǔ)法糖，其工作方式與本機(jī)PHPrange函數(shù)相同。同樣有用的選項(xiàng)是向循環(huán)添加條件。使用條件，我們可以過(guò)濾要迭代的元素。假設(shè)我們想要迭代所有值小於250的產(chǎn)品：

<?php
// 加載我們的自動(dòng)加載器
require_once __DIR__.'/vendor/autoload.php';

// 指定我們的Twig模板位置
$loader = new Twig_Loader_Filesystem(__DIR__.'/templates');

// 實(shí)例化我們的Twig
$twig = new Twig_Environment($loader);

條件語(yǔ)句

Twig還以if、elseif、if not和else標(biāo)籤的形式提供條件語(yǔ)句。就像在任何編程語(yǔ)言中一樣，我們可以使用這些標(biāo)籤來(lái)過(guò)濾模板中的條件。假設(shè)在我們的示例中，我們只想顯示值高於500的產(chǎn)品：

<?php
require_once __DIR__.'/bootstrap.php';

// 創(chuàng)建產(chǎn)品列表
$products = [
    [
        'name'          => 'Notebook',
        'description'   => 'Core i7',
        'value'         =>  800.00,
        'date_register' => '2017-06-22',
    ],
    [
        'name'          => 'Mouse',
        'description'   => 'Razer',
        'value'         =>  125.00,
        'date_register' => '2017-10-25',
    ],
    [
        'name'          => 'Keyboard',
        'description'   => 'Mechanical Keyboard',
        'value'         =>  250.00,
        'date_register' => '2017-06-23',
    ],
];

// 渲染我們的視圖
echo $twig->render('index.html', ['products' => $products] );

過(guò)濾器

過(guò)濾器允許我們過(guò)濾傳遞給模板的信息以及顯示信息的格式。讓我們看看一些最常用和最重要的過(guò)濾器。 Twig過(guò)濾器的完整列表可以在這裡找到。

日期和`date_modify`

date過(guò)濾器將日期格式化為給定格式。正如我們?cè)谑纠锌吹降模?/p>

<!DOCTYPE html>
<html lang="pt-BR">
    <head>
        <meta charset="UTF-8">
        <title>Twig Example</title>
    </head>
    <body>
    <table> border="1" style="width: 80%;">
        <thead>
            <tr>
                <td>Product</td>
                <td>Description</td>
                <td>Value</td>
                <td>Date</td>
            </tr>
        </thead>
        <tbody>
            {% for product in products %}
                <tr>
                    <td>{{ product.name }}</td>
                    <td>{{ product.description }}</td>
                    <td>{{ product.value }}</td>
                    <td>{{ product.date_register|date("m/d/Y") }}</td>
                </tr>
            {% endfor %}
        </tbody>
    </table>
    </body>
</html>

我們以月/日/年的格式顯示日期。除了date過(guò)濾器之外，我們還可以使用修飾符字符串使用date_modify過(guò)濾器更改日期。例如，如果我們想向日期添加一天，我們可以使用以下內(nèi)容：

<!DOCTYPE html>
<html lang="pt-BR">
    <head>
        <meta charset="UTF-8">
        <title>Tutorial Example</title>
    </head>
    <body>
        {% block content %}
        {% endblock %}
    </body>
</html>

`format`

通過(guò)替換所有佔(zhàn)位符來(lái)格式化給定字符串。例如：

{% extends "layout.html" %}

{% block content %}
    <table> border="1" style="width: 80%;">
        <thead>
            <tr>
                <td>Product</td>
                <td>Description</td>
                <td>Value</td>
                <td>Date</td>
            </tr>
        </thead>
        <tbody>
            {% for product in products %}
                <tr>
                    <td>{{ product.name }}</td>
                    <td>{{ product.description }}</td>
                    <td>{{ product.value }}</td>
                    <td>{{ product.date_register|date("m/d/Y") }}</td>
                </tr>
            {% endfor %}
        </tbody>
    </table>
{% endblock %}

`striptags`

striptags過(guò)濾器去除SGML/XML標(biāo)籤，並將相鄰的空格替換為空格：

<?php echo "<p> Hello " . $name . "</p>"; ?>

`escape`

escape是最重要的過(guò)濾器之一。它過(guò)濾字符串以安全地插入最終輸出中。默認(rèn)情況下，它使用HTML轉(zhuǎn)義策略，因此

<p>Hello {{ name }}</p>

等效於

composer require twig/twig

js、css、url和html_attr轉(zhuǎn)義策略也可使用。它們分別為Javascript、CSS、URI和HTML屬性上下文轉(zhuǎn)義字符串。

調(diào)試

最後，讓我們來(lái)看看調(diào)試。有時(shí)我們需要訪問(wèn)模板變量的所有信息。為此，Twig具有dump()函數(shù)。此函數(shù)默認(rèn)情況下不可用。在創(chuàng)建Twig環(huán)境時(shí)，我們必須添加Twig_Extension_Debug擴(kuò)展：

<?php
// 加載我們的自動(dòng)加載器
require_once __DIR__.'/vendor/autoload.php';

// 指定我們的Twig模板位置
$loader = new Twig_Loader_Filesystem(__DIR__.'/templates');

// 實(shí)例化我們的Twig
$twig = new Twig_Environment($loader);

此步驟是必要的，這樣我們才不會(huì)意外地在生產(chǎn)服務(wù)器上洩露調(diào)試信息。配置完成後，我們只需使用dump()函數(shù)即可轉(zhuǎn)儲(chǔ)有關(guān)模板變量的所有信息。

<?php
require_once __DIR__.'/bootstrap.php';

// 創(chuàng)建產(chǎn)品列表
$products = [
    [
        'name'          => 'Notebook',
        'description'   => 'Core i7',
        'value'         =>  800.00,
        'date_register' => '2017-06-22',
    ],
    [
        'name'          => 'Mouse',
        'description'   => 'Razer',
        'value'         =>  125.00,
        'date_register' => '2017-10-25',
    ],
    [
        'name'          => 'Keyboard',
        'description'   => 'Mechanical Keyboard',
        'value'         =>  250.00,
        'date_register' => '2017-06-23',
    ],
];

// 渲染我們的視圖
echo $twig->render('index.html', ['products' => $products] );

結(jié)論

希望本文能為您提供Twig基礎(chǔ)知識(shí)的堅(jiān)實(shí)基礎(chǔ)，並立即啟動(dòng)您的項(xiàng)目！如果您想更深入地了解Twig，官方網(wǎng)站提供了您可以查閱的非常好的文檔和參考。您使用模板引擎嗎？您對(duì)Twig有什麼看法？您會(huì)將它與Blade或Smarty等流行的替代方案進(jìn)行比較嗎？

(以下內(nèi)容為FAQ，原文已包含，此處略去)

以上是樹枝 - 最受歡迎的獨(dú)立PHP模板引擎的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！

本網(wǎng)站聲明

本文內(nèi)容由網(wǎng)友自願(yuàn)投稿，版權(quán)歸原作者所有。本站不承擔(dān)相應(yīng)的法律責(zé)任。如發(fā)現(xiàn)涉嫌抄襲或侵權(quán)的內(nèi)容，請(qǐng)聯(lián)絡(luò)admin@php.cn