Include 标签

Testing Is Documentation

tests/View/Compiler/CompilerIncludeTest.php

可以使用 include 标签来包含外部的模板文件。

Uses

<?php

use Leevel\Kernel\Utils\Api;

使用完整文件名包含

使用方法如下：

{% include file="完整模板文件名" %}

这种情况下，模板文件名必须包含后缀。

public function testBaseUse(): void
{
    $parser = $this->createParser();

    $source = <<<'eot'
        {% include file="themes/header.html" %}
        eot;

    $compiled = <<<'eot'
        <?php echo $this->display('themes/header', [], '.html'); ?>
        eot;

    self::assertSame($compiled, $parser->doCompile($source, null, true));
}

使用 ext 定义模板文件后缀

public function testExt(): void
{
    $parser = $this->createParser();

    $source = <<<'eot'
        {% include file="hello" ext=".tpl" %}
        eot;

    $compiled = <<<'eot'
        <?php echo $this->display('hello', [], '.tpl'); ?>
        eot;

    self::assertSame($compiled, $parser->doCompile($source, null, true));
}

使用变量定义完整的文件

public function testVar(): void
{
    $parser = $this->createParser();

    $source = <<<'eot'
        {{~ $headTpl = \Leevel::themesPath() . '/' . 'header.html' }}
        {% include file="$headTpl" %}
        eot;

    $compiled = <<<'eot'
        <?php $headTpl = \Leevel::themesPath() . '/' . 'header.html'; ?>
        <?php echo $this->display($headTpl); ?>
        eot;

    self::assertSame($compiled, $parser->doCompile($source, null, true));
}

包含当前视图目录下的模板文件

public function testInViewDir(): void
{
    $parser = $this->createParser();

    $source = <<<'eot'
        {% include file="test" %}
        eot;

    $compiled = <<<'eot'
        <?php echo $this->display('test'); ?>
        eot;

    self::assertSame($compiled, $parser->doCompile($source, null, true));
}

包含其他模块的操作模板

其中模块以目录分隔

public function testOtherModule(): void
{
    $parser = $this->createParser();

    $source = <<<'eot'
        {% include file="public/header" %}
        eot;

    $compiled = <<<'eot'
        <?php echo $this->display('public/header'); ?>
        eot;

    self::assertSame($compiled, $parser->doCompile($source, null, true));
}

函数表达式支持

表达式语法为 () 包裹起来并且括号周围不能有空格。

public function testExpr(): void
{
    $parser = $this->createParser();

    // 防止 . 被替换加上 () 包裹起来
    $source = <<<'eot'
        {% include file="($path . '/' . $name)" %}
        {% include file="(Template::tpl('header'))" %}
        {% include file="(tpl('header'))" %}
        {% include file=" (not_expression) " %}
        {% include file="1 (not_expression) " %}
        {% include file="$hello" %}
        eot;

    $compiled = <<<'eot'
        <?php echo $this->display($path . '/' . $name); ?>
        <?php echo $this->display(Template::tpl('header')); ?>
        <?php echo $this->display(tpl('header')); ?>
        <?php echo $this->display(' (not_expression) '); ?>
        <?php echo $this->display('1 (not_expression) '); ?>
        <?php echo $this->display($hello); ?>
        eot;

    self::assertSame($compiled, $parser->doCompile($source, null, true));
}