README

此包提供了一个单一的@Template注解，可以用来替代SensioFrameworkExtraBundle中同名注解。

工作原理

您可以在tests/Annotation/TemplateTest.php中的DummyController中看到作为参考。完全支持Twig，这将使编写模板更容易。

要求

• PHP 7.1
• SensioFrameworkExtraBundle 5.1
• Twig 2.4

安装

该包可以通过Composer安装

composer require jaem3l/template-bundle

当在用Flex引导的Symfony 4应用程序中使用此包时，请确保已安装twig-bundle并设置其配方，例如使用composer req twig。

路由注解的使用示例

<?php

namespace App\Controller;

use jæm3l\TemplateBundle\Annotation\Template;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;

class HelloController
{
    /**
     * @Route("/hello1")
     * @Template("Hello World")
     */
    public function simpleHelloAction()
    {
    }

    /**
     * @Route("/hello2 ")
     * @Template("Hello {{ name }}")
     */
    public function advancedHelloAction()
    {
        return [
            'name' => 'Santa Claus',
        ];
    }

    /**
     * @Route("/twig")
     * @Template("{{ 1 + 2 }}")
     */
    public function simpleExpressionAction()
    {
    }

    /**
     * @Route("/advanced_hello ")
     * @Template("
     * {% extends 'base.html.twig' %}
     *
     * {% block body %}
     * Hello {{ name }}!
     * {% endblock %}
     * ")
     */
    public function advancedTemplateAction()
    {
        return [
            'name' => 'Santa Claus',
        ];
    }
}

模板控制器使用示例

在您的路由中，现在可以依赖此控制器直接渲染提供的模板。

# SF3: app/config/routing.yml
# SF4: config/routes.yaml

hello_world:
    path: /hello-world
    controller: jæm3l\TemplateBundle\Controller\TemplateController::template
    defaults:
        template: 'Hello World!'
        
twig_expression:
    path: /twig-expression
    controller: jæm3l\TemplateBundle\Controller\TemplateController::template
    defaults:
        template: '{{ 1 + 2 }}'
        
advanced_template:
    path: /advanced-template
    controller: jæm3l\TemplateBundle\Controller\TemplateController
    defaults:
        template: |
            {% extends 'base.html.twig' %}

            {% block body %}
            Hello World!
            {% endblock %}