Twig_Node_Module Class Reference

Represents a module node. More...

Inheritance diagram for Twig_Node_Module:

Collaboration diagram for Twig_Node_Module:

Public Member Functions
	__construct (Twig_NodeInterface $body, Twig_Node_Expression $parent=null, Twig_NodeInterface $blocks, Twig_NodeInterface $macros, Twig_NodeInterface $traits, $embeddedTemplates, $name, $source='')
	setIndex ($index)
	compile (Twig_Compiler $compiler)
	Compiles the node to PHP. More...
Public Member Functions inherited from Twig_Node
	__construct (array $nodes=array(), array $attributes=array(), $lineno=0, $tag=null)
	Constructor. More...
	__toString ()
	toXml ($asDom=false)
	compile (Twig_Compiler $compiler)
	Compiles the node to PHP. More...
	getTemplateLine ()
	getLine ()
	getNodeTag ()
	hasAttribute ($name)
	getAttribute ($name)
	setAttribute ($name, $value)
	removeAttribute ($name)
	hasNode ($name)
	getNode ($name)
	setNode ($name, $node=null)
	removeNode ($name)
	count ()
	getIterator ()
	setTemplateName ($name)
	getTemplateName ()
	setFilename ($name)
	getFilename ()

Protected Member Functions
	compileTemplate (Twig_Compiler $compiler)
	compileGetParent (Twig_Compiler $compiler)
	compileClassHeader (Twig_Compiler $compiler)
	compileConstructor (Twig_Compiler $compiler)
	compileDisplay (Twig_Compiler $compiler)
	compileClassFooter (Twig_Compiler $compiler)
	compileMacros (Twig_Compiler $compiler)
	compileGetTemplateName (Twig_Compiler $compiler)
	compileIsTraitable (Twig_Compiler $compiler)
	compileDebugInfo (Twig_Compiler $compiler)
	compileGetSource (Twig_Compiler $compiler)
	compileGetSourceContext (Twig_Compiler $compiler)
	compileLoadTemplate (Twig_Compiler $compiler, $node, $var)

Private Attributes
	$source

Additional Inherited Members
Protected Attributes inherited from Twig_Node
	$nodes
	$attributes
	$lineno
	$tag

Detailed Description

Represents a module node.

Consider this class as being final. If you need to customize the behavior of the generated class, consider adding nodes to the following nodes: display_start, display_end, constructor_start, constructor_end, and class_end.

Author

Fabien Potencier fabie.nosp@m.n@sy.nosp@m.mfony.nosp@m..com

Definition at line 22 of file Module.php.

Constructor & Destructor Documentation

__construct()

Twig_Node_Module::__construct	(	Twig_NodeInterface	$body,
		Twig_Node_Expression	$parent = null,
		Twig_NodeInterface	$blocks,
		Twig_NodeInterface	$macros,
		Twig_NodeInterface	$traits,
			$embeddedTemplates,
			$name,
			$source = ''
	)

Definition at line 26 of file Module.php.

References Twig_Node\$name, Twig_Node\$nodes, $source, array, and Twig_Node\setTemplateName().

    {
        if (!$name instanceof Twig_Source) {
            @trigger_error(sprintf('Passing a string as the $name argument of %s() is deprecated since version 1.27. Pass a Twig_Source instance instead.', __METHOD__), E_USER_DEPRECATED);
            $this->source = new Twig_Source($source, $name);
        } else {
            $this->source = $name;
        }

        $nodes = array(
            'body' => $body,
            'blocks' => $blocks,
            'macros' => $macros,
            'traits' => $traits,
            'display_start' => new Twig_Node(),
            'display_end' => new Twig_Node(),
            'constructor_start' => new Twig_Node(),
            'constructor_end' => new Twig_Node(),
            'class_end' => new Twig_Node(),
        );
        if (null !== $parent) {
            $nodes['parent'] = $parent;
        }

        // embedded templates are set as attributes so that they are only visited once by the visitors
        parent::__construct($nodes, array(
            // source to be remove in 2.0
            'source' => $this->source->getCode(),
            // filename to be remove in 2.0 (use getTemplateName() instead)
            'filename' => $this->source->getName(),
            'index' => null,
            'embedded_templates' => $embeddedTemplates,
        ), 1);

        // populate the template name of all node children
        $this->setTemplateName($this->source->getName());
    }

Here is the call graph for this function:

Member Function Documentation

compile()

Twig_Node_Module::compile

(

Twig_Compiler

$compiler

)

Compiles the node to PHP.

Implements Twig_NodeInterface.

Definition at line 69 of file Module.php.

References $template, compileTemplate(), Twig_Node\getAttribute(), and Twig_Compiler\subcompile().

    {
        $this->compileTemplate($compiler);

        foreach ($this->getAttribute('embedded_templates') as $template) {
            $compiler->subcompile($template);
        }
    }

Here is the call graph for this function:

compileClassFooter()

Twig_Node_Module::compileClassFooter ( Twig_Compiler  $compiler )

protected

Definition at line 322 of file Module.php.

References Twig_Node\getNode(), and Twig_Compiler\subcompile().

Referenced by compileTemplate().

    {
        $compiler
            ->subcompile($this->getNode('class_end'))
            ->outdent()
            ->write("}\n")
        ;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

compileClassHeader()

Twig_Node_Module::compileClassHeader ( Twig_Compiler  $compiler )

protected

Definition at line 153 of file Module.php.

References Twig_Node\getAttribute(), Twig_Compiler\getEnvironment(), and Twig_Compiler\write().

Referenced by compileTemplate().

    {
        $compiler
            ->write("\n\n")
            // if the template name contains */, add a blank to avoid a PHP parse error
            ->write('/* '.str_replace('*/', '* /', $this->source->getName())." */\n")
            ->write('class '.$compiler->getEnvironment()->getTemplateClass($this->source->getName(), $this->getAttribute('index')))
            ->raw(sprintf(" extends %s\n", $compiler->getEnvironment()->getBaseTemplateClass()))
            ->write("{\n")
            ->indent()
        ;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

compileConstructor()

Twig_Node_Module::compileConstructor ( Twig_Compiler  $compiler )

protected

Definition at line 166 of file Module.php.

References $i, $key, Twig_Node\$name, Twig_Compiler\addDebugInfo(), compileLoadTemplate(), Twig_Node\count(), Twig_Node\getNode(), Twig_Node\hasNode(), Twig_Compiler\indent(), Twig_Compiler\outdent(), and Twig_Compiler\write().

Referenced by compileTemplate().

    {
        $compiler
            ->write("public function __construct(Twig_Environment \$env)\n", "{\n")
            ->indent()
            ->subcompile($this->getNode('constructor_start'))
            ->write("parent::__construct(\$env);\n\n")
        ;

        // parent
        if (!$this->hasNode('parent')) {
            $compiler->write("\$this->parent = false;\n\n");
        } elseif (($parent = $this->getNode('parent')) && $parent instanceof Twig_Node_Expression_Constant) {
            $compiler
                ->addDebugInfo($parent)
                ->write('$this->parent = $this->loadTemplate(')
                ->subcompile($parent)
                ->raw(', ')
                ->repr($this->source->getName())
                ->raw(', ')
                ->repr($parent->getTemplateLine())
                ->raw(");\n")
            ;
        }

        $countTraits = count($this->getNode('traits'));
        if ($countTraits) {
            // traits
            foreach ($this->getNode('traits') as $i => $trait) {
                $this->compileLoadTemplate($compiler, $trait->getNode('template'), sprintf('$_trait_%s', $i));

                $compiler
                    ->addDebugInfo($trait->getNode('template'))
                    ->write(sprintf("if (!\$_trait_%s->isTraitable()) {\n", $i))
                    ->indent()
                    ->write("throw new Twig_Error_Runtime('Template \"'.")
                    ->subcompile($trait->getNode('template'))
                    ->raw(".'\" cannot be used as a trait.');\n")
                    ->outdent()
                    ->write("}\n")
                    ->write(sprintf("\$_trait_%s_blocks = \$_trait_%s->getBlocks();\n\n", $i, $i))
                ;

                foreach ($trait->getNode('targets') as $key => $value) {
                    $compiler
                        ->write(sprintf('if (!isset($_trait_%s_blocks[', $i))
                        ->string($key)
                        ->raw("])) {\n")
                        ->indent()
                        ->write("throw new Twig_Error_Runtime(sprintf('Block ")
                        ->string($key)
                        ->raw(' is not defined in trait ')
                        ->subcompile($trait->getNode('template'))
                        ->raw(".'));\n")
                        ->outdent()
                        ->write("}\n\n")

                        ->write(sprintf('$_trait_%s_blocks[', $i))
                        ->subcompile($value)
                        ->raw(sprintf('] = $_trait_%s_blocks[', $i))
                        ->string($key)
                        ->raw(sprintf(']; unset($_trait_%s_blocks[', $i))
                        ->string($key)
                        ->raw("]);\n\n")
                    ;
                }
            }

            if ($countTraits > 1) {
                $compiler
                    ->write("\$this->traits = array_merge(\n")
                    ->indent()
                ;

                for ($i = 0; $i < $countTraits; ++$i) {
                    $compiler
                        ->write(sprintf('$_trait_%s_blocks'.($i == $countTraits - 1 ? '' : ',')."\n", $i))
                    ;
                }

                $compiler
                    ->outdent()
                    ->write(");\n\n")
                ;
            } else {
                $compiler
                    ->write("\$this->traits = \$_trait_0_blocks;\n\n")
                ;
            }

            $compiler
                ->write("\$this->blocks = array_merge(\n")
                ->indent()
                ->write("\$this->traits,\n")
                ->write("array(\n")
            ;
        } else {
            $compiler
                ->write("\$this->blocks = array(\n")
            ;
        }

        // blocks
        $compiler
            ->indent()
        ;

        foreach ($this->getNode('blocks') as $name => $node) {
            $compiler
                ->write(sprintf("'%s' => array(\$this, 'block_%s'),\n", $name, $name))
            ;
        }

        if ($countTraits) {
            $compiler
                ->outdent()
                ->write(")\n")
            ;
        }

        $compiler
            ->outdent()
            ->write(");\n")
            ->outdent()
            ->subcompile($this->getNode('constructor_end'))
            ->write("}\n\n")
        ;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

compileDebugInfo()

Twig_Node_Module::compileDebugInfo ( Twig_Compiler  $compiler )

protected

Definition at line 401 of file Module.php.

References Twig_Compiler\getDebugInfo(), and Twig_Compiler\write().

Referenced by compileTemplate().

    {
        $compiler
            ->write("public function getDebugInfo()\n", "{\n")
            ->indent()
            ->write(sprintf("return %s;\n", str_replace("\n", '', var_export(array_reverse($compiler->getDebugInfo(), true), true))))
            ->outdent()
            ->write("}\n\n")
        ;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

compileDisplay()

Twig_Node_Module::compileDisplay ( Twig_Compiler  $compiler )

protected

Definition at line 295 of file Module.php.

References Twig_Compiler\addDebugInfo(), Twig_Node\getNode(), Twig_Node\hasNode(), Twig_Compiler\raw(), Twig_Compiler\subcompile(), and Twig_Compiler\write().

Referenced by compileTemplate().

    {
        $compiler
            ->write("protected function doDisplay(array \$context, array \$blocks = array())\n", "{\n")
            ->indent()
            ->subcompile($this->getNode('display_start'))
            ->subcompile($this->getNode('body'))
        ;

        if ($this->hasNode('parent')) {
            $parent = $this->getNode('parent');
            $compiler->addDebugInfo($parent);
            if ($parent instanceof Twig_Node_Expression_Constant) {
                $compiler->write('$this->parent');
            } else {
                $compiler->write('$this->getParent($context)');
            }
            $compiler->raw("->display(\$context, array_merge(\$this->blocks, \$blocks));\n");
        }

        $compiler
            ->subcompile($this->getNode('display_end'))
            ->outdent()
            ->write("}\n\n")
        ;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

compileGetParent()

Twig_Node_Module::compileGetParent ( Twig_Compiler  $compiler )

protected

Definition at line 118 of file Module.php.

References Twig_Node\getNode(), Twig_Node\hasNode(), Twig_Compiler\raw(), Twig_Compiler\subcompile(), and Twig_Compiler\write().

Referenced by compileTemplate().

    {
        if (!$this->hasNode('parent')) {
            return;
        }
        $parent = $this->getNode('parent');

        $compiler
            ->write("protected function doGetParent(array \$context)\n", "{\n")
            ->indent()
            ->addDebugInfo($parent)
            ->write('return ')
        ;

        if ($parent instanceof Twig_Node_Expression_Constant) {
            $compiler->subcompile($parent);
        } else {
            $compiler
                ->raw('$this->loadTemplate(')
                ->subcompile($parent)
                ->raw(', ')
                ->repr($this->source->getName())
                ->raw(', ')
                ->repr($parent->getTemplateLine())
                ->raw(')')
            ;
        }

        $compiler
            ->raw(";\n")
            ->outdent()
            ->write("}\n\n")
        ;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

compileGetSource()

Twig_Node_Module::compileGetSource ( Twig_Compiler  $compiler )

protected

Definition at line 412 of file Module.php.

References Twig_Compiler\write().

Referenced by compileTemplate().

    {
        $compiler
            ->write("/** @deprecated since 1.27 (to be removed in 2.0). Use getSourceContext() instead */\n")
            ->write("public function getSource()\n", "{\n")
            ->indent()
            ->write("@trigger_error('The '.__METHOD__.' method is deprecated since version 1.27 and will be removed in 2.0. Use getSourceContext() instead.', E_USER_DEPRECATED);\n\n")
            ->write('return $this->getSourceContext()->getCode();')
            ->raw("\n")
            ->outdent()
            ->write("}\n\n")
        ;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

compileGetSourceContext()

Twig_Node_Module::compileGetSourceContext ( Twig_Compiler  $compiler )

protected

Definition at line 426 of file Module.php.

References Twig_Compiler\getEnvironment(), and Twig_Compiler\write().

Referenced by compileTemplate().

    {
        $compiler
            ->write("public function getSourceContext()\n", "{\n")
            ->indent()
            ->write('return new Twig_Source(')
            ->string($compiler->getEnvironment()->isDebug() ? $this->source->getCode() : '')
            ->raw(', ')
            ->string($this->source->getName())
            ->raw(', ')
            ->string($this->source->getPath())
            ->raw(");\n")
            ->outdent()
            ->write("}\n")
        ;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

compileGetTemplateName()

Twig_Node_Module::compileGetTemplateName ( Twig_Compiler  $compiler )

protected

Definition at line 336 of file Module.php.

References Twig_Compiler\write().

Referenced by compileTemplate().

    {
        $compiler
            ->write("public function getTemplateName()\n", "{\n")
            ->indent()
            ->write('return ')
            ->repr($this->source->getName())
            ->raw(";\n")
            ->outdent()
            ->write("}\n\n")
        ;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

compileIsTraitable()

Twig_Node_Module::compileIsTraitable ( Twig_Compiler  $compiler )

protected

Definition at line 349 of file Module.php.

References Twig_Node\$nodes, array, Twig_Node\count(), Twig_Node\getNode(), Twig_Node\hasNode(), and Twig_Compiler\write().

Referenced by compileTemplate().

    {
        // A template can be used as a trait if:
        //   * it has no parent
        //   * it has no macros
        //   * it has no body
        //
        // Put another way, a template can be used as a trait if it
        // only contains blocks and use statements.
        $traitable = !$this->hasNode('parent') && 0 === count($this->getNode('macros'));
        if ($traitable) {
            if ($this->getNode('body') instanceof Twig_Node_Body) {
                $nodes = $this->getNode('body')->getNode(0);
            } else {
                $nodes = $this->getNode('body');
            }

            if (!count($nodes)) {
                $nodes = new Twig_Node(array($nodes));
            }

            foreach ($nodes as $node) {
                if (!count($node)) {
                    continue;
                }

                if ($node instanceof Twig_Node_Text && ctype_space($node->getAttribute('data'))) {
                    continue;
                }

                if ($node instanceof Twig_Node_BlockReference) {
                    continue;
                }

                $traitable = false;
                break;
            }
        }

        if ($traitable) {
            return;
        }

        $compiler
            ->write("public function isTraitable()\n", "{\n")
            ->indent()
            ->write(sprintf("return %s;\n", $traitable ? 'true' : 'false'))
            ->outdent()
            ->write("}\n\n")
        ;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

compileLoadTemplate()

Twig_Node_Module::compileLoadTemplate ( Twig_Compiler  $compiler,   $node,   $var  )

protected

Definition at line 443 of file Module.php.

References Twig_Compiler\write().

Referenced by compileConstructor().

    {
        if ($node instanceof Twig_Node_Expression_Constant) {
            $compiler
                ->write(sprintf('%s = $this->loadTemplate(', $var))
                ->subcompile($node)
                ->raw(', ')
                ->repr($node->getTemplateName())
                ->raw(', ')
                ->repr($node->getTemplateLine())
                ->raw(");\n")
            ;
        } else {
            throw new LogicException('Trait templates can only be constant nodes.');
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

compileMacros()

Twig_Node_Module::compileMacros ( Twig_Compiler  $compiler )

protected

Definition at line 331 of file Module.php.

References Twig_Node\getNode(), and Twig_Compiler\subcompile().

Referenced by compileTemplate().

    {
        $compiler->subcompile($this->getNode('macros'));
    }

Here is the call graph for this function:

Here is the caller graph for this function:

compileTemplate()

Twig_Node_Module::compileTemplate ( Twig_Compiler  $compiler )

protected

Definition at line 78 of file Module.php.

References compileClassFooter(), compileClassHeader(), compileConstructor(), compileDebugInfo(), compileDisplay(), compileGetParent(), compileGetSource(), compileGetSourceContext(), compileGetTemplateName(), compileIsTraitable(), compileMacros(), Twig_Node\count(), Twig_Node\getAttribute(), Twig_Node\getNode(), Twig_Node\hasNode(), Twig_Compiler\subcompile(), and Twig_Compiler\write().

Referenced by compile().

    {
        if (!$this->getAttribute('index')) {
            $compiler->write('<?php');
        }

        $this->compileClassHeader($compiler);

        if (
            count($this->getNode('blocks'))
            || count($this->getNode('traits'))
            || !$this->hasNode('parent')
            || $this->getNode('parent') instanceof Twig_Node_Expression_Constant
            || count($this->getNode('constructor_start'))
            || count($this->getNode('constructor_end'))
        ) {
            $this->compileConstructor($compiler);
        }

        $this->compileGetParent($compiler);

        $this->compileDisplay($compiler);

        $compiler->subcompile($this->getNode('blocks'));

        $this->compileMacros($compiler);

        $this->compileGetTemplateName($compiler);

        $this->compileIsTraitable($compiler);

        $this->compileDebugInfo($compiler);

        $this->compileGetSource($compiler);

        $this->compileGetSourceContext($compiler);

        $this->compileClassFooter($compiler);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setIndex()

Twig_Node_Module::setIndex

(

$index

)

Definition at line 64 of file Module.php.

References $index, and Twig_Node\setAttribute().

Referenced by Twig_Parser\embedTemplate().

    {
        $this->setAttribute('index', $index);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$source

Twig_Node_Module::$source

private

Definition at line 24 of file Module.php.

Referenced by __construct().

---

The documentation for this class was generated from the following file:

• libs/composer/vendor/twig/twig/lib/Twig/Node/Module.php