View

Testing Is Documentation

tests/View/ManagerTest.php

视图统一由视图组件完成，通常我们使用代理 \Leevel\View\Proxy\View 类进行静态调用。

内置支持的视图驱动类型包括 html、phpui，未来可能增加其他驱动。

使用方式

使用容器 view 服务

\App::make('views')->setVar(array|string $name, mixed $value = null): void;

依赖注入

class Demo
{
    private \Leevel\View\Manager $view;

    public function __construct(\Leevel\View\Manager $view)
    {
        $this->view = $view;
    }
}

使用静态代理

\Leevel\Router\Proxy\View::setVar(array|string $name, mixed $value = null): void;

view 配置

系统的 view 配置位于应用下面的 option/view.php 文件。

可以定义多个视图连接，并且支持切换，每一个连接支持驱动设置。

<?php

declare(strict_types=1);

return [
    /*
     * ---------------------------------------------------------------
     * 默认视图驱动
     * ---------------------------------------------------------------
     *
     * 系统为所有视图提供了统一的接口，在使用上拥有一致性
     */
    'default' => Leevel::env('VIEW_DRIVER', 'html'),

    /*
     * ---------------------------------------------------------------
     * 错误模板
     * ---------------------------------------------------------------
     *
     * 默认错误跳转对应的模板文件
     */
    'fail' => 'public/fail',

    /*
     * ---------------------------------------------------------------
     * 成功模板
     * ---------------------------------------------------------------
     *
     * 默认成功跳转对应的模板文件
     */
    'success' => 'public/success',

    /*
     * ---------------------------------------------------------------
     * 视图连接参数
     * ---------------------------------------------------------------
     *
     * 这里为所有的视图的连接参数，每一种不同的驱动拥有不同的配置
     * 虽然有不同的驱动，但是在视图使用上却有着一致性
     */
    'connect' => [
        'html' => [
            // driver
            'driver' => 'html',

            // 驱动类
            'driver_class' => \Leevel\View\Html::class,

            // 后缀
            'suffix' => '.html',
        ],

        'phpui' => [
            // driver
            'driver' => 'phpui',

            // 驱动类
            'driver_class' => \Leevel\View\Phpui::class,

            // 后缀
            'suffix' => '.php',
        ],
    ],
];

视图参数根据不同的连接会有所区别，通用的 view 参数如下：

配置项	配置描述
fail	错误模板
success	成功模板

Uses

<?php

use Leevel\Di\Container;
use Leevel\Di\IContainer;
use Leevel\Filesystem\Helper;
use Leevel\Kernel\App;
use Leevel\Kernel\Utils\Api;
use Leevel\Option\Option;
use Leevel\View\Manager;

视图基本使用

public function testBaseUse(): void
{
    $manager = $this->createManager();
    $manager->setVar('foo', 'bar');
    $result = $manager->display('html_test');
    static::assertSame('hello html,bar.', $result);
}

PHP 自身作为模板

public function testPhpUi(): void
{
    $manager = $this->createManager('phpui');

    $manager->setVar('hello', 'world');
    static::assertSame('world', $manager->getVar('hello'));
    static::assertSame('world', $manager->connect('phpui')->getVar('hello'));
}

getVar 获取变量值

public function testGetVar(): void
{
    $manager = $this->createManager();

    $manager->setVar('hello', 'world');
    static::assertSame('world', $manager->getVar('hello'));
    static::assertNull($manager->getVar('hello2'));
}

getVar 获取所有变量值

public function testGetVarAll(): void
{
    $manager = $this->createManager();

    $manager->setVar('hello', 'world');
    static::assertSame(['hello' => 'world'], $manager->getVar());
}

deleteVar 删除变量值

public function testDeleteVar(): void
{
    $manager = $this->createManager('phpui');

    $manager->setVar('hello', 'world');
    static::assertSame('world', $manager->getVar('hello'));
    static::assertSame('world', $manager->connect('phpui')->getVar('hello'));

    $manager->deleteVar(['hello']);
    static::assertNull($manager->getVar('hello'));
    static::assertNull($manager->connect('phpui')->getVar('hello'));
}

clearVar 清空变量值

public function testClearVar(): void
{
    $manager = $this->createManager();

    $manager->setVar('foo', 'bar');
    static::assertSame('bar', $manager->getVar('foo'));
    static::assertSame('bar', $manager->connect('html')->getVar('foo'));

    $manager->clearVar();
    static::assertNull($manager->getVar('foo'));
    static::assertNull($manager->connect('html')->getVar('foo'));
}

display 加载视图文件

public function testDisplay(): void
{
    $manager = $this->createManager('phpui');

    $manager->setVar('foo', 'bar');
    static::assertSame(
        'Hi here! bar',
        $manager->display(__DIR__.'/assert/hello.php')
    );
}