Twig - 如果启用了调试模式,则显示模板名称

时间:2016-02-02 14:48:35

标签: twig twig-extension

我最近使用的是Twig,我想知道是否可以输出页面上加载的模板名称。我能想到的最好方法是将模板本身上方的名称显示为html注释。

<!-- start @default/_components/_wrapper/form-wrapper.html.twig -->
    <form>
       ...
    </form>
<!-- end @default/_components/_wrapper/form-wrapper.html.twig -->

我知道我可以通过插入{{ _self.templateName }}来获取模板名称,但我不想将其添加到每个模板或部分模板中。

该解决方案应该适用于{% include %}{% use %}等,如果只是在启用调试模式时才会发生这种情况。

我试着写一个扩展名,但不管我怎么说,我都要在每个模板中做一些调用。

这背后的原因是我试图减少搜索其他人实施的模板的时间,因为项目越来越大。

注意:我使用Symfony NOT

在此先感谢,任何帮助表示赞赏!

3 个答案:

答案 0 :(得分:1)

实现此目的的最简单方法是使用您自己的Template

<?php
    namespace My\ProjectName\Here;

    abstract class Template extends \Twig_Template {

        public function render(array $context) {
            $level = ob_get_level();
            ob_start();
            try {
                $this->display($context);
            } catch (Exception $e) {
                while (ob_get_level() > $level) {
                    ob_end_clean();
                }
                throw $e;
            }
            $content = ob_get_clean();
            return '<!-- Template  start : ' . $this->getTemplateName() . ' -->'. $content.'<!-- Template  end : ' . $this->getTemplateName() . ' -->';     
        }

并将其注册到Twig

<?php   
    $loader = new Twig_Loader_Filesystem(__DIR__ . '/../CMS4U/Views');
    $twig = new Twig_Environment($loader, array(
        'base_template_class'   => '\My\ProjectName\Here\Template',
    ));

答案 1 :(得分:1)

感谢@DarkBee我指出了正确的方向并最终使用了这个:我创建了一个debug-template.class.php,内容如下:

<?php

abstract class DebugTemplate extends Twig_Template {

    public function display(array $context, array $blocks = array())
    {
        // workaround - only add the html comment when the partial is loaded with @
        if(substr($this->getTemplateName(),0,1) == '@') {
            echo '<!-- START: ' . $this->getTemplateName() . ' -->';
        }

        $this->displayWithErrorHandling($this->env->mergeGlobals($context), array_merge($this->blocks, $blocks));

        if(substr($this->getTemplateName(),0,1) == '@') {
            echo '<!-- END: ' . $this->getTemplateName() . ' -->';
        }

    }
}
?>

然后我拿走了index.php并添加了

require_once 'vendor/twig/twig/lib/Twig/TemplateInterface.php';
require_once 'vendor/twig/twig/lib/Twig/Template.php';

并添加了DebugTemplate类

$twig = new Twig_Environment($loader, array(
    'cache' => false,
    'base_template_class' => 'DebugTemplate'
));

结果就是我想要的,看起来像这样

<!-- START: @default/_components/panel.html.twig -->
        <div class="panel panel-default">
<!-- END: @default/_components/panel.html.twig -->

答案 2 :(得分:0)

感谢Frank Hofmann的另一个有用功能是在模板中也渲染现有块的开始/结束。请注意,并非所有的树枝模板都是纯HTML。 HTML注释将破坏CSS或JS代码。可以避免这种情况,例如使用命名约定...

<?php
abstract class App_Twig_DebugTemplate extends Twig_Template
{
    public function display(array $context, array $blocks = [])
    {
        $this->_renderComment('BEGIN TEMPLATE: ' . $this->getTemplateName());
        $this->displayWithErrorHandling($this->env->mergeGlobals($context), array_merge($this->blocks, $blocks));
        $this->_renderComment('END TEMPLATE: ' . $this->getTemplateName());
    }

    public function displayBlock($name, array $context, array $blocks = [], $useBlocks = true)
    {
        $this->_renderComment('BEGIN BLOCK: ' . $name);
        parent::displayBlock($name, $context, $blocks, $useBlocks);
        $this->_renderComment('END BLOCK: ' . $name);
    }

    /**
     * @param string $comment
     */
    private function _renderComment($comment)
    {
        $extension = pathinfo($this->getTemplateName(), PATHINFO_EXTENSION);
        if (in_array($extension, [
            'css',
            'js',
        ])) {
            echo '/* ' . $comment . ' */';
        } else {
            echo '<!-- ' . $comment . ' -->';
        }
    }
}