模板引擎

Yii3 通过灵活的渲染器系统支持多种模板引擎。默认情况下，PHP 用作模板引擎，但您可以轻松添加对其他引擎（如 Twig 和 Blade）的支持，或创建自己的自定义渲染器。

PHP 模板在“视图”指南部分中有描述。

Twig 模板引擎

Twig 是一种现代模板引擎，提供更适合设计师的语法。要在您的 Yii3 应用程序中使用 Twig，您需要安装 Twig 扩展。

bash

composer require yiisoft/view-twig

现在您可以使用 .twig 模板。例如，views/site/about.twig：

twig

{# Variable type hints for IDE support #}
{# @var user \App\Entity\User #}
{# @var posts \App\Entity\Post[] #}

<div class="user-profile">
    <h1>{{ user.name }}</h1>
    <p>Email: {{ user.email }}</p>
    
    {% if posts is not empty %}
        <h2>Recent Posts</h2>
        <ul class="posts">
            {% for post in posts %}
                <li>
                    <h3>{{ post.title }}</h3>
                    <p>{{ post.excerpt }}</p>
                    <time>{{ post.publishedAt|date('F j, Y') }}</time>
                </li>
            {% endfor %}
        </ul>
    {% else %}
        <p>No posts available.</p>
    {% endif %}
</div>

Twig 特性

自动转义：Twig 自动转义 HTML 上下文中的变量：

twig

{# Automatically escaped #}
<h1>{{ title }}</h1>

{# Raw output (use carefully) #}
<div>{{ content|raw }}</div>

过滤器和函数：Twig 提供了许多内置过滤器和函数：

twig

{# Date formatting #}
<time>{{ post.createdAt|date('Y-m-d H:i') }}</time>

{# String manipulation #}
<p>{{ description|truncate(100) }}</p>

{# URL generation #}
<a href="{{ path('user.profile', {'id': user.id}) }}">Profile</a>

模板继承：Twig 支持模板继承：

views/layout/main.twig

twig

<!DOCTYPE html>
<html>
<head>
    <title>{% block title %}Default Title{% endblock %}</title>
</head>
<body>
    <main>
        {% block content %}{% endblock %}
    </main>
</body>
</html>

views/site/about.twig

twig

{% extends "layout/main.twig" %}

{% block title %}About Us{% endblock %}

{% block content %}
    <h1>About Our Company</h1>
    <p>Welcome to our website!</p>
{% endblock %}

渲染 Twig 模板

以与 PHP 模板相同的方式使用 Twig 模板：

php

// In your controller
public function about(): ResponseInterface
{
    return $this->viewRenderer->render('about.twig', [
        'user' => $this->getCurrentUser(),
        'posts' => $this->getRecentPosts(),
    ]);
}

自定义模板引擎

您可以通过实现 TemplateRendererInterface 来创建自定义模板引擎：

php

<?php

declare(strict_types=1);

namespace App\View;

use Yiisoft\View\TemplateRendererInterface;

final class MarkdownRenderer implements TemplateRendererInterface
{
    public function __construct(
        private MarkdownParserInterface $parser,
    ) {}

    public function render(string $template, array $parameters = []): string
    {
        $content = file_get_contents($template);
        
        // Replace placeholders with parameters
        foreach ($parameters as $key => $value) {
            $content = str_replace("{{$key}}", (string) $value, $content);
        }
        
        return $this->parser->parse($content);
    }
}

注册您的自定义渲染器：

php

use Yiisoft\Container\Reference;

// In configuration
'yiisoft/view' => [
    'renderers' => [
        'md' => Reference::to(App\View\MarkdownRenderer::class),
    ],
],

现在您可以使用 .md 模板文件：

views/content/help.md

markdown

# Help: {{title}}

Welcome, {{username}}!

This is a Markdown template with **bold** and *italic* text.

- Feature 1
- Feature 2
- Feature 3

选择合适的模板引擎

在以下情况下使用 PHP 模板：

您需要最大的灵活性和性能
您的团队熟悉 PHP
您希望利用现有的 PHP 知识
您需要在模板中使用复杂逻辑（尽管应尽量减少）

在以下情况下使用 Twig 模板：

您希望逻辑与表示之间有更严格的分离
您与喜欢更简洁语法的设计师合作
您需要自动转义和安全功能
您需要模板继承和高级功能

在以下情况下使用自定义模板：

您有 PHP 或 Twig 无法满足的特定要求
您正在处理专业的内容格式
您需要与外部模板系统集成

最佳实践

保持模板简单：将复杂逻辑移至控制器或服务
始终转义输出：通过正确转义变量来防止 XSS 攻击
使用有意义的名称：清晰地命名模板和变量
组织模板：将相关模板分组到子目录中
记录变量：始终添加类型提示以获得更好的 IDE 支持
避免业务逻辑：将业务逻辑保留在模型和服务中

模板引擎 ​

Twig 模板引擎 ​

Twig 特性 ​

渲染 Twig 模板 ​

自定义模板引擎 ​

选择合适的模板引擎 ​

最佳实践 ​

模板引擎

Twig 模板引擎

Twig 特性

渲染 Twig 模板

自定义模板引擎

选择合适的模板引擎

最佳实践