所以，我对交响乐和树枝还是相当陌生的。我想知道如何最好地在模板中包含/创建可重用代码片段。例如，假设你有一个侧边栏，你想在每一页上显示。

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

{% block body %}
    <div id="wrapper">
        <div id="content-container">
            {# Main content... #}
        </div>
        <div id="sidebar">
            {% include 'sidebar.html.twig' %}
        </div>
    </div>
{% endblock %}

边栏中有几个小部件，它们都有自己的逻辑。你如何去创建/包括这些小部件？

到目前为止，我遇到了几个解决方案。

第一个是将小部件作为控制器嵌入Twig中。

class WidgetController extends Controller
{
    public function recentArticlesWidgetAction()
    {
        // some logic to generate to required widget data
        // ...

        // Render custom widget template with data
        return $this->render('widgets/recentArticles.html.twig', array('data' => $data)
        );
    }
    public function subscribeButtonWidgetAction()
    {
        // ...

        return $this->render('widgets/subscribeButton.html.twig', array('data' => $data)
    }

    // Many more widgets
    // ...
}

并将其包含在“侧边栏”中。html。像这样的树枝

<div id="sidebar">        
    {# Recent Articles widget #}
    {{ render(controller('AppBundle:Widget:recentArticlesWidget' )) }}

    {# Subscribe-Button widget #}
    {{ render(controller('AppBundle:Widget:subscribeButtonWidget' )) }}

    {# and so on #}
</div>

我还看到一些人将小部件注册为服务（可以直接在Twig中使用）。与小部件主类

// src/AppBundle/Service/RecentArticlesWidget.php
namespace AppBundle\Service;

use Symfony\Component\DependencyInjection\ContainerInterface;

class RecentArticlesWidget
{
    protected $container;

    public function __construct(ContainerInterface $container)
    {
        $this->container = $container;
    }

    public function getRecentArticles()
    {
        // do some logic (use container for doctrine etc.)
    }
}

然后注册为服务，

# src/AppBundle/Resources/config/services.yml
services:
    recentArticlesWidget:
        class:     AppBundle\Service\RecentArticlesWidget
        arguments: ["@service_container"]

传递到控制器中的模板，

namespace AppBundle\Controller;

class SidebarController {

    public function showAction($request) {

        // Get the widget(s) 
        $recentArticlesWidget = $this->get('recentArticlesWidget'); 

        // Pass it (them) along
        return $this->render('sidebar.html.twig', array('recentArticlesWidget' => $recentArticlesWidget));
    }
}

所以它可以像这样简单地用在树枝上

{# sidebar.html.twig #}

{{ recentArticlesWidget.getRecentArticles()|raw }}

或者，您也可以通过将服务添加到Twig配置，直接将其添加到Twig全局变量。这样，它就不需要由控制器传递到视图中。

#app/config/config.yml
twig:
    globals:
        # twig_var_name: symfony_service
        recentArticlesWidget: "@recentArticlesWidget"

这与使用上述服务非常相似（请参阅文档）。您创建了一个与前面显示的服务几乎相同的twig扩展类

// src/AppBundle/Twig/RecentArticlesWidgetExtension.php
namespace AppBundle\Twig;

class RecentArticlesWidgetExtension extends \Twig_Extension
{
    protected $container;

    public function __construct(ContainerInterface $container)
    {
        $this->container = $container;
    }

    public function getFunctions()
    {
        return array( 
            "getRecentArticles" => new Twig_Function_Method($this, "getRecentArticles")
            // register more functions
        );
    }

    public function getRecentArticles()
    {
        // do some logic (use container for doctrine etc.)
    }

    // Some more functions...

    public function getName()
    {
        return 'WidgetExtension';
    }
}

使用添加的标记将其注册为服务

# src/AppBundle/Resources/config/services.yml
services:
    recentArticlesWidget:
        class: AppBundle\Twig\RecentArticlesWidgetExtension
        arguments: [@service_container]
        tags:
            - { name: twig.extension }

并简单地将其用作细枝中的全局函数

{# sidebar.html.twig #}

{{ getRecentArticles() }}

我注意到的一点是，在最后两种方法中，逻辑和视图似乎不再分离。您基本上编写了一个小部件函数，并让该函数输出小部件的完整html。这似乎与Symfony试图实现的模块化和模式背道而驰。

另一方面，为每个小部件调用不同的控制器或控制器操作（带有它们自己的树枝渲染）似乎需要比需要更多的处理。我不确定它是否真的减慢了速度，但我确实想知道它是否过度了。

长话短说，在Symfony中使用可重用的小部件有最佳实践吗？我相信其中一些方法也可以混合使用，所以我只是想知道如何最好地实现这一点。