2025最全Symfony TwigBundle实战指南：从入门到精通模板引擎开发-优快云博客

2025最全Symfony TwigBundle实战指南：从入门到精通模板引擎开发

【免费下载链接】twig-bundle Provides a tight integration of Twig into the Symfony full-stack framework 项目地址: https://gitcode.com/gh_mirrors/tw/twig-bundle

引言：为什么选择TwigBundle？

你还在为Symfony项目中的模板管理而烦恼吗？还在纠结如何写出简洁、高效且安全的视图代码吗？Symfony TwigBundle（模板引擎捆绑包）为你提供了完美解决方案。作为Symfony官方推荐的模板引擎，TwigBundle不仅带来了优雅的模板语法，还提供了与Symfony框架的深度集成，让模板开发变得前所未有的轻松高效。

读完本文后，你将能够：

快速掌握Twig模板引擎的核心概念和语法
熟练配置和优化TwigBundle以提升性能
利用高级功能如模板继承、宏和过滤器构建可维护的视图层
实现模板缓存、调试和测试的最佳实践
解决常见的TwigBundle使用问题和性能瓶颈

TwigBundle简介与核心优势

TwigBundle是什么？

TwigBundle是Symfony框架的官方模板引擎捆绑包，它将Twig模板引擎（Twig Template Engine）无缝集成到Symfony全栈框架中。Twig是一个灵活、快速且安全的PHP模板引擎，它允许开发者编写简洁、可读性强的模板代码，同时提供了丰富的功能来处理变量、循环、条件判断等常见模板需求。

TwigBundle的核心优势

特性	描述	优势
简洁语法	使用`{{ }}`输出变量，`{% %}`控制结构，`{# #}`注释	提高可读性，减少模板代码量
自动转义	默认开启HTML转义，防止XSS攻击	增强应用安全性
模板继承	支持模板继承和布局重用	提高代码复用率，简化维护
宏支持	类似函数的宏功能，可封装常用模板片段	减少重复代码，提高开发效率
过滤器系统	丰富的内置过滤器，支持自定义过滤器	简化数据处理和格式化
沙箱模式	可限制模板中允许的操作	增强安全性，适合用户提供的模板
缓存机制	模板编译缓存，提高渲染性能	减少服务器负载，提升响应速度
调试工具	详细的错误信息和调试支持	简化问题定位和修复

技术架构概览

mermaid

安装与基础配置

系统要求与依赖

根据composer.json文件，TwigBundle的最低要求如下：

PHP: 8.2或更高版本
Symfony框架组件: 6.4或7.0版本
Twig模板引擎: 3.12或更高版本

安装步骤

使用Composer安装

在Symfony项目根目录下执行以下命令：

composer require symfony/twig-bundle

确认安装结果

安装完成后，你应该能在composer.json文件中看到如下依赖：

{
    "require": {
        "symfony/twig-bundle": "^7.3"
    }
}

基础配置详解

TwigBundle的配置主要通过config/packages/twig.yaml文件进行。以下是一个基础配置示例：

twig:
    default_path: '%kernel.project_dir%/templates'
    debug: '%kernel.debug%'
    strict_variables: '%kernel.debug%'
    cache: '%kernel.cache_dir%/twig'
    form_themes: ['form_div_layout.html.twig']
    globals:
        app: '@App\Twig\AppGlobal'
    paths:
        '%kernel.project_dir%/src/AcmeBundle/Resources/views': AcmeBundle
    date:
        format: 'Y-m-d H:i:s'
        interval_format: '%d days'
        timezone: 'Asia/Shanghai'
    number_format:
        decimals: 2
        decimal_point: '.'
        thousands_separator: ','

关键配置项说明

配置项	说明	默认值
default_path	默认模板路径	%kernel.project_dir%/templates
debug	是否开启调试模式	%kernel.debug%
strict_variables	是否启用严格变量检查	%kernel.debug%
cache	缓存目录	%kernel.cache_dir%/twig
form_themes	表单主题模板	['form_div_layout.html.twig']
globals	全局变量定义	[]
paths	额外模板路径	[]
date.format	默认日期格式	'F j, Y H:i'
date.interval_format	默认时间间隔格式	'%d days'
date.timezone	默认时区	null (使用系统时区)
number_format.decimals	默认小数位数	0
number_format.decimal_point	小数点符号	'.'
number_format.thousands_separator	千位分隔符	','

模板基础与语法

模板文件结构

Symfony项目中，模板文件默认存放在templates/目录下。一个典型的Symfony项目模板结构如下：

templates/
├── base.html.twig          # 基础模板
├── home/
│   └── index.html.twig     # 首页模板
├── user/
│   ├── profile.html.twig   # 用户资料页模板
│   └── list.html.twig      # 用户列表页模板
└── bundles/
    └── AcmeBundle/         # 第三方Bundle模板覆盖

基本语法规则

变量输出

使用双花括号{{ }}输出变量：

{{ user.name }}
{{ product.price|number_format(2) }}

控制结构

使用{% %}标签实现控制结构：

{% if user.isAdmin %}
    <p>Welcome, administrator!</p>
{% elseif user.isLoggedIn %}
    <p>Welcome back, {{ user.name }}!</p>
{% else %}
    <p>Please log in.</p>
{% endif %}

{% for item in items %}
    <li>{{ loop.index }}: {{ item.name }}</li>
{% endfor %}

注释

使用{# #}添加注释：

{# 这是一个Twig模板注释，不会输出到HTML #}
{# 
    多行注释示例
    第二行内容
#}

模板继承与包含

定义基础模板(base.html.twig)

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>{% block title %}My Website{% endblock %}</title>
    {% block stylesheets %}{% endblock %}
</head>
<body>
    <header>
        {% block header %}
            <h1>My Website</h1>
        {% endblock %}
    </header>
    
    <main>
        {% block body %}{% endblock %}
    </main>
    
    <footer>
        {% block footer %}
            <p>&copy; {{ "now"|date("Y") }} My Website</p>
        {% endblock %}
    </footer>
    
    {% block javascripts %}{% endblock %}
</body>
</html>

继承并扩展基础模板

{% extends 'base.html.twig' %}

{% block title %}Home Page{% endblock %}

{% block body %}
    <h2>Welcome to our home page</h2>
    <p>Current time: {{ "now"|date("H:i:s") }}</p>
{% endblock %}

包含子模板

<div class="sidebar">
    {% include 'sidebar.html.twig' with {'items': menuItems} %}
</div>

宏(Macros)的使用

宏类似于其他编程语言中的函数，用于封装可重用的模板片段。

定义宏

创建templates/macros/form.html.twig文件：

{% macro input(name, value, type = "text", attributes = {}) %}
    {% set attributes = attributes|merge({
        type: type,
        name: name,
        value: value
    }) %}
    
    <input {{ attributes|xml_encode }}>
{% endmacro %}

{% macro select(name, options, selected = null, attributes = {}) %}
    <select name="{{ name }}" {{ attributes|xml_encode }}>
        {% for value, label in options %}
            <option value="{{ value }}" {% if value == selected %}selected{% endif %}>
                {{ label }}
            </option>
        {% endfor %}
    </select>
{% endmacro %}

使用宏

{% import "macros/form.html.twig" as formMacros %}

{{ formMacros.input('username', app.request.get('username')) }}

{{ formMacros.select('country', {
    'us': 'United States',
    'cn': 'China',
    'jp': 'Japan'
}, app.request.get('country')) }}

核心功能与高级特性

过滤器(Filter)详解

过滤器用于修改变量的值，格式为{{ variable|filter_name(arguments) }}。

常用内置过滤器

过滤器	描述	示例	输出
upper	转换为大写	`{{ "hello"\|upper }}`	HELLO
lower	转换为小写	`{{ "HELLO"\|lower }}`	hello
capitalize	首字母大写	`{{ "hello world"\|capitalize }}`	Hello world
date	日期格式化	`{{ "now"\|date("Y-m-d") }}`	2025-09-06
number_format	数字格式化	`{{ 12345.67\|number_format(2) }}`	12,345.67
json_encode	JSON编码	`{{ {a: 'b'}\|json_encode }}`	{"a":"b"}
yaml_encode	YAML编码	`{{ {a: 'b'}\|yaml_encode }}`	a: b
trans	翻译文本	`{{ 'hello'\|trans }}`	你好 (取决于翻译文件)
length	获取长度	`{{ [1,2,3]\|length }}`	3
join	数组转字符串	`{{ [1,2,3]\|join(',') }}`	1,2,3
reverse	反转数组	`{{ [1,2,3]\|reverse\|join(',') }}`	3,2,1
slice	切片操作	`{{ "hello"\|slice(1,3) }}`	ell
replace	字符串替换	`{{ "hello"\|replace({'h': 'H', 'e': 'E'}) }}`	HEllo

自定义过滤器开发

创建自定义过滤器需要两个步骤：创建过滤器类和注册过滤器。

创建过滤器类：

// src/Twig/AppExtension.php
namespace App\Twig;

use Twig\Extension\AbstractExtension;
use Twig\TwigFilter;

class AppExtension extends AbstractExtension
{
    public function getFilters(): array
    {
        return [
            new TwigFilter('price_format', [$this, 'formatPrice']),
            new TwigFilter('truncate', [$this, 'truncateText']),
        ];
    }
    
    public function formatPrice(float $price, string $currency = 'USD'): string
    {
        $formatter = new \NumberFormatter('en_US', \NumberFormatter::CURRENCY);
        return $formatter->formatCurrency($price, $currency);
    }
    
    public function truncateText(string $text, int $length = 50, string $suffix = '...'): string
    {
        if (mb_strlen($text) <= $length) {
            return $text;
        }
        
        return mb_substr($text, 0, $length) . $suffix;
    }
}

注册过滤器（Symfony 4+会自动发现）：

# config/services.yaml
services:
    App\Twig\AppExtension:
        tags: ['twig.extension']

使用自定义过滤器：

{{ product.price|price_format('CNY') }}
{{ article.content|truncate(100) }}

函数(Function)详解

函数用于执行特定操作并返回结果，格式为{{ function_name(arguments) }}。

常用内置函数

函数	描述	示例
path	生成路由URL	`{{ path('article_show', {id: article.id}) }}`
url	生成绝对路由URL	`{{ url('article_show', {id: article.id}) }}`
asset	生成静态资源URL	`{{ asset('css/style.css') }}`
is_granted	检查用户权限	`{{ is_granted('ROLE_ADMIN') }}`
include	包含模板片段	`{{ include('components/sidebar.html.twig') }}`
render	渲染控制器	`{{ render(controller('App\\Controller\\ArticleController::latest')) }}`
dump	调试变量	`{{ dump(user) }}`

创建自定义函数

与创建自定义过滤器类似，创建自定义函数也需要创建扩展类：

// src/Twig/AppExtension.php
namespace App\Twig;

use Twig\Extension\AbstractExtension;
use Twig\TwigFunction;

class AppExtension extends AbstractExtension
{
    public function getFunctions(): array
    {
        return [
            new TwigFunction('article_count', [$this, 'getArticleCount']),
            new TwigFunction('is_feature_enabled', [$this, 'isFeatureEnabled']),
        ];
    }
    
    private $articleRepository;
    
    public function __construct(ArticleRepository $articleRepository)
    {
        $this->articleRepository = $articleRepository;
    }
    
    public function getArticleCount(?string $category = null): int
    {
        return $this->articleRepository->countByCategory($category);
    }
    
    public function isFeatureEnabled(string $feature): bool
    {
        // 实际项目中可能从数据库或配置文件读取
        $features = [
            'dark_mode' => true,
            'comment' => true,
            'rating' => false
        ];
        
        return $features[$feature] ?? false;
    }
}

使用自定义函数：

<p>Total articles: {{ article_count() }}</p>
<p>Tech articles: {{ article_count('tech') }}</p>

{% if is_feature_enabled('dark_mode') %}
    <button id="dark-mode-toggle">Toggle Dark Mode</button>
{% endif %}

模板命名空间与路径配置

Twig支持使用命名空间来组织模板，避免模板路径过长或冲突。

配置命名空间路径

在twig.yaml中配置：

twig:
    paths:
        '%kernel.project_dir%/src/AdminBundle/Resources/views': Admin
        '%kernel.project_dir%/src/FrontBundle/Resources/views': Front
        '%kernel.project_dir%/templates/components': Components

使用命名空间引用模板

{# 引用AdminBundle中的模板 #}
{% extends '@Admin/layout.html.twig' %}

{# 包含Components命名空间中的模板 #}
{% include '@Components/navigation.html.twig' %}

{# 从Front命名空间导入宏 #}
{% import '@Front/macros/form.html.twig' as frontForm %}

条件包含与动态模板

根据不同条件加载不同模板或内容：

基于环境的模板包含

{% if app.environment == 'dev' %}
    {% include '@Debug/toolbar.html.twig' %}
{% endif %}

基于用户角色的内容显示

{% if is_granted('ROLE_ADMIN') %}
    {% include 'admin/controls.html.twig' %}
{% endif %}

动态模板路径

{% set template = 'products/' ~ product.type ~ '.html.twig' %}
{% include template with {product: product} only %}

模板属性(Template Attributes)

Symfony 6.2+引入了模板属性功能，允许在模板中定义元数据：

{# templates/article/show.html.twig #}
{% extends 'base.html.twig' %}

{% template_attributes 'seo' with {
    'title': article.title,
    'description': article.summary,
    'keywords': article.tags|join(',')
} %}

{% block body %}
    <h1>{{ article.title }}</h1>
    <div class="content">
        {{ article.content|markdown_to_html }}
    </div>
{% endblock %}

在控制器中访问模板属性：

public function show(Article $article, EngineInterface $twig): Response
{
    $template = $twig->load('article/show.html.twig');
    $seoAttributes = $template->getAttributes()->get('seo');
    
    return $this->render($template, [
        'article' => $article,
        'seo' => $seoAttributes,
    ]);
}

性能优化与缓存策略

缓存机制详解

TwigBundle的缓存机制可以显著提高模板渲染性能，其工作原理如下：

Twig将模板编译为PHP类
编译后的PHP类存储在缓存目录中
后续请求直接加载编译后的PHP类，跳过解析和编译步骤

mermaid

缓存配置优化

twig:
    cache: '%kernel.cache_dir%/twig'
    # 生产环境禁用自动重载
    auto_reload: '%kernel.debug%'

缓存预热(Cache Warmer)

TwigBundle提供了模板缓存预热器，可以在部署时预编译所有模板：

// src/Command/WarmupTwigCacheCommand.php
namespace App\Command;

use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Bundle\TwigBundle\CacheWarmer\TemplateCacheWarmer;

class WarmupTwigCacheCommand extends Command
{
    private $cacheWarmer;
    
    public function __construct(TemplateCacheWarmer $cacheWarmer)
    {
        parent::__construct();
        $this->cacheWarmer = $cacheWarmer;
    }
    
    protected function configure()
    {
        $this->setName('twig:cache:warmup')
             ->setDescription('Warms up the Twig template cache');
    }
    
    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $output->writeln('Warming up Twig template cache...');
        
        $this->cacheWarmer->warmUp(
            $this->getContainer()->getParameter('kernel.cache_dir'),
            $this->getContainer()->getParameter('kernel.build_dir')
        );
        
        $output->writeln('Twig template cache warmed up successfully.');
        
        return Command::SUCCESS;
    }
}

执行缓存预热：

php bin/console twig:cache:warmup

性能优化最佳实践

1. 合理使用`only`关键字

限制传递给包含模板的变量，减少不必要的数据处理：

{# 不推荐 #}
{% include 'components/comment.html.twig' with {comment: comment} %}

{# 推荐 #}
{% include 'components/comment.html.twig' with {comment: comment} only %}

2. 使用`source()`函数替代`include`用于静态内容

对于纯静态内容，使用source()函数可以避免变量解析开销：

{# 不推荐 #}
{% include 'static/footer.html.twig' %}

{# 推荐 #}
{{ source('static/footer.html.twig') }}

3. 避免在循环中使用复杂表达式

将复杂计算移到循环外部或使用变量缓存结果：

{# 不推荐 #}
{% for product in products %}
    <div class="price">{{ product.price * taxRate|number_format(2) }}</div>
{% endfor %}

{# 推荐 #}
{% set taxRate = app.config.get('app.tax_rate') %}
{% for product in products %}
    {% set price = product.price * taxRate %}
    <div class="price">{{ price|number_format(2) }}</div>
{% endfor %}

4. 使用宏代替重复逻辑

将重复的模板逻辑封装为宏，提高代码复用率：

{% macro product_card(product) %}
    <div class="product-card">
        <h3>{{ product.name }}</h3>
        <p class="price">{{ product.price|price_format }}</p>
        <img src="{{ product.image|product_image_url }}" alt="{{ product.name }}">
    </div>
{% endmacro %}

{# 在循环中使用宏 #}
{% for product in products %}
    {{ _self.product_card(product) }}
{% endfor %}

5. 监控模板性能

使用Symfony Profiler监控模板渲染时间：

mermaid

调试与测试

开启调试模式

在开发环境中开启Twig调试模式：

# config/packages/twig.yaml
twig:
    debug: true
    strict_variables: true

使用Twig调试工具

Dump变量

使用dump()函数查看变量内容：

{{ dump(user, products) }}

模板追踪

Symfony Profiler的Twig面板显示了所有渲染的模板及其继承关系：

mermaid

模板单元测试

使用Twig的测试工具测试模板输出：

创建测试类

// tests/Twig/ArticleListTest.php
namespace App\Tests\Twig;

use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
use Twig\Environment;

class ArticleListTest extends KernelTestCase
{
    public function testArticleListRendering()
    {
        self::bootKernel();
        $twig = self::getContainer()->get(Environment::class);
        
        $articles = [
            (object) ['id' => 1, 'title' => 'Test Article 1', 'content' => 'Content 1'],
            (object) ['id' => 2, 'title' => 'Test Article 2', 'content' => 'Content 2'],
        ];
        
        $template = $twig->load('article/list.html.twig');
        $output = $template->render(['articles' => $articles]);
        
        $this->assertStringContainsString('Test Article 1', $output);
        $this->assertStringContainsString('Test Article 2', $output);
        $this->assertCount(2, explode('<article>', $output) - 1);
    }
}

使用Lint命令验证模板语法

Symfony提供了lint:twig命令检查模板语法错误：

# 检查单个模板
php bin/console lint:twig templates/article/show.html.twig

# 检查整个目录
php bin/console lint:twig templates/

# 检查Bundle中的模板
php bin/console lint:twig @AcmeBundle

集成到CI/CD流程

在composer.json中添加脚本：

{
    "scripts": {
        "lint:twig": "php bin/console lint:twig templates/"
    }
}

在CI配置中添加：

# .github/workflows/php.yml
jobs:
    lint:
        runs-on: ubuntu-latest
        steps:
            - uses: actions/checkout@v3
            - name: Install dependencies
              run: composer install
            - name: Lint Twig templates
              run: composer run-script lint:twig

常见问题调试技巧

变量未定义错误

Twig\Error\RuntimeError: Variable "product" does not exist in "article/show.html.twig" at line 5.

解决步骤：

确认模板中使用的变量名是否正确
检查传递给模板的变量是否包含该变量
使用defined测试变量是否存在：

{% if product is defined %}
    {{ product.name }}
{% else %}
    <p>Product not found</p>
{% endif %}

模板继承问题

当块内容不显示时，检查：

父模板中是否定义了相应的块
子模板是否正确使用{% extends %}指令
块名称是否拼写正确

{# 错误示例 #}
{% extends 'base.html.twig' %}

{# 块名称错误，应为"content"而非"contant" #}
{% block contant %}
    ...
{% endblock %}

过滤器不存在错误

Twig\Error\SyntaxError: The filter "price_format" does not exist in "product/show.html.twig" at line 10.

解决步骤：

检查过滤器名称拼写是否正确
确认自定义过滤器所在的Twig扩展是否已正确注册
检查是否需要添加相应的Symfony组件

与Symfony其他组件的集成

与表单组件集成

TwigBundle提供了对Symfony表单组件的完整支持。

配置表单主题

# config/packages/twig.yaml
twig:
    form_themes:
        - 'bootstrap_5_layout.html.twig'
        - '@App/form/custom_layout.html.twig'

渲染表单

{# 基础表单渲染 #}
{{ form_start(form) }}
    {{ form_widget(form) }}
    <button type="submit" class="btn btn-primary">Submit</button>
{{ form_end(form) }}

{# 自定义表单渲染 #}
{{ form_start(form, {'attr': {'class': 'custom-form'}}) }}
    <div class="form-group">
        {{ form_label(form.name) }}
        {{ form_widget(form.name, {'attr': {'class': 'form-control'}}) }}
        {{ form_errors(form.name) }}
    </div>
    
    <div class="form-group">
        {{ form_label(form.email) }}
        {{ form_widget(form.email, {'attr': {'class': 'form-control'}}) }}
        {{ form_errors(form.email) }}
    </div>
    
    <button type="submit" class="btn btn-primary">Register</button>
{{ form_end(form) }}

与安全组件集成

利用Twig扩展实现权限控制：

{% if is_granted('ROLE_ADMIN') %}
    <a href="{{ path('user_edit', {id: user.id}) }}">Edit User</a>
{% endif %}

{% if is_granted('EDIT', article) %}
    <a href="{{ path('article_edit', {id: article.id}) }}">Edit Article</a>
{% endif %}

{# 限制内容显示 #}
{% if is_granted('VIEW_PREMIUM_CONTENT') %}
    {{ article.premium_content|markdown_to_html }}
{% else %}
    {{ article.summary|markdown_to_html }}
    <a href="{{ path('subscription_upgrade') }}">Upgrade to view full content</a>
{% endif %}

与翻译组件集成

使用Twig翻译过滤器实现多语言支持：

{# 基础翻译 #}
<h1>{{ 'welcome.title'|trans }}</h1>

{# 带参数的翻译 #}
<p>{{ 'welcome.message'|trans({'%name%': user.name}) }}</p>

{# 复数形式 #}
<p>{{ 'article.comments'|transchoice(article.commentCount, {'%count%': article.commentCount}) }}</p>

{# 显式指定语言 #}
<p>{{ 'greeting'|trans([], 'messages', 'fr') }}</p>

翻译文件示例：

# translations/messages.en.yaml
welcome.title: "Welcome to Our Website"
welcome.message: "Hello %name%, welcome back!"
article.comments: "{0} No comments|{1} One comment|]1,Inf] %count% comments"
greeting: "Hello"

# translations/messages.fr.yaml
welcome.title: "Bienvenue sur notre site web"
welcome.message: "Bonjour %name%, bienvenue de retour !"
article.comments: "{0} Aucun commentaire|{1} Un commentaire|]1,Inf] %count% commentaires"
greeting: "Bonjour"

与资产(Asset)组件集成

使用Twig资产函数管理静态资源：

{# 基础资产引用 #}
<link rel="stylesheet" href="{{ asset('css/style.css') }}">
<script src="{{ asset('js/app.js') }}"></script>
<img src="{{ asset('images/logo.png') }}" alt="Logo">

{# 版本化资产 #}
<link rel="stylesheet" href="{{ asset('css/style.css') }}?v={{ app.version }}">

{# 使用资产包 #}
{% block stylesheets %}
    {{ parent() }}
    {{ encore_entry_link_tags('app') }}
{% endblock %}

{% block javascripts %}
    {{ parent() }}
    {{ encore_entry_script_tags('app') }}
{% endblock %}

与邮件组件集成

使用Twig模板创建邮件内容：

{# templates/emails/registration.html.twig #}
{% extends '@Email/email.html.twig' %}

{% block subject %}Welcome to Our Service{% endblock %}

{% block body %}
    <h1>Welcome, {{ user.name }}!</h1>
    
    <p>Thank you for registering with our service. Your account has been created successfully.</p>
    
    <p>To complete your registration, please click the following link:</p>
    
    <a href="{{ url('registration_confirm', {token: user.confirmationToken}) }}">
        Confirm my account
    </a>
    
    <p>Best regards,<br>The Team</p>
{% endblock %}

在控制器中使用模板发送邮件：

public function register(Request $request, MailerInterface $mailer): Response
{
    // ... 表单处理逻辑 ...
    
    $email = (new TemplatedEmail())
        ->to($user->getEmail())
        ->from('noreply@example.com')
        ->htmlTemplate('emails/registration.html.twig')
        ->context([
            'user' => $user,
        ]);
        
    $mailer->send($email);
    
    // ... 其他逻辑 ...
}

部署与最佳实践

生产环境配置

生产环境中的优化配置：

# config/packages/prod/twig.yaml
twig:
    debug: false
    strict_variables: false
    cache: '%kernel.cache_dir%/twig'
    auto_reload: false
    optimizations: -1  # 启用所有优化

缓存预热与清理

部署时预热缓存

# 预热所有缓存（包括Twig模板缓存）
php bin/console cache:warmup --env=prod

# 仅预热Twig模板缓存
php bin/console twig:cache:warmup --env=prod

清理缓存

# 清理所有缓存
php bin/console cache:clear --env=prod

# 强制清理（在共享主机环境中）
rm -rf var/cache/prod/*

多环境配置管理

为不同环境创建不同的Twig配置：

config/
├── packages/
│   ├── twig.yaml          # 通用配置
│   ├── dev/
│   │   └── twig.yaml      # 开发环境配置
│   ├── test/
│   │   └── twig.yaml      # 测试环境配置
│   └── prod/
│       └── twig.yaml      # 生产环境配置

环境特定配置示例（开发环境）：

# config/packages/dev/twig.yaml
twig:
    debug: true
    strict_variables: true
    auto_reload: true
    cache: false  # 开发环境禁用缓存以实时查看更改

2025最全Symfony TwigBundle实战指南：从入门到精通模板引擎开发