View

Testing Is Documentation

tests/Router/ViewTest.phpView - 图1

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

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

使用方式

使用容器 view 服务

  1. \App::make('view')->setVar($name, $value = null): void;

依赖注入

  1. class Demo
  2. {
  3.     private \Leevel\Router\IView $view;
  5.     public function __construct(\Leevel\Router\IView $view)
  6.     {
  7.         $this->view = $view;
  8.     }
  9. }

使用静态代理

  1. \Leevel\Router\Proxy\View::setVar($name, $value = null): void;

view 配置

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

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

  1. <?php
  3. declare(strict_types=1);
  5. /*
  6.  * This file is part of the your app package.
  7.  *
  8.  * The PHP Application For Code Poem For You.
  9.  * (c) 2018-2099 http://yourdomian.com All rights reserved.
  10.  *
  11.  * For the full copyright and license information, please view the LICENSE
  12.  * file that was distributed with this source code.
  13.  */
  15. return [
  16.     /*
  17.      * ---------------------------------------------------------------
  18.      * 默认视图驱动
  19.      * ---------------------------------------------------------------
  20.      *
  21.      * 系统为所有视图提供了统一的接口，在使用上拥有一致性
  22.      */
  23.     'default' => Leevel::env('VIEW_DRIVER', 'html'),
  25.     /*
  26.      * ---------------------------------------------------------------
  27.      * 错误模板
  28.      * ---------------------------------------------------------------
  29.      *
  30.      * 默认错误跳转对应的模板文件
  31.      */
  32.     'fail' => 'fail',
  34.     /*
  35.      * ---------------------------------------------------------------
  36.      * 成功模板
  37.      * ---------------------------------------------------------------
  38.      *
  39.      * 默认成功跳转对应的模板文件
  40.      */
  41.     'success' => 'success',
  43.     /*
  44.      * ---------------------------------------------------------------
  45.      * 视图连接参数
  46.      * ---------------------------------------------------------------
  47.      *
  48.      * 这里为所有的视图的连接参数，每一种不同的驱动拥有不同的配置
  49.      * 虽然有不同的驱动，但是在视图使用上却有着一致性
  50.      */
  51.     'connect' => [
  52.         'html' => [
  53.             // driver
  54.             'driver' => 'html',
  56.             // 后缀
  57.             'suffix' => '.html',
  58.         ],
  60.         'phpui' => [
  61.             // driver
  62.             'driver' => 'phpui',
  64.             // 后缀
  65.             'suffix' => '.php',
  66.         ],
  67.     ],
  68. ];

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

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

Uses

  1. <?php
  3. use Leevel\Router\IView;
  4. use Leevel\Router\View;
  5. use Leevel\View\Html;
  6. use Leevel\View\Phpui;

视图基本使用

  1. public function testBaseUse(): void
  2. {
  3.     $view = new View(
  4.         $html = new Html()
  5.     );
  6.     $this->assertInstanceof(IView::class, $view);
  8.     $view->setVar('hello', 'world');
  9.     $this->assertSame('world', $view->getVar('hello'));
  10.     $this->assertSame('world', $html->getVar('hello'));
  11. }

deleteVar 删除变量值

  1. public function testDeleteVar(): void
  2. {
  3.     $view = new View(
  4.         $html = new Html()
  5.     );
  7.     $view->setVar('hello', 'world');
  8.     $this->assertSame('world', $view->getVar('hello'));
  9.     $this->assertSame('world', $html->getVar('hello'));
  11.     $view->deleteVar(['hello']);
  12.     $this->assertNull($view->getVar('hello'));
  13.     $this->assertNull($html->getVar('hello'));
  14. }

clearVar 清空变量值

  1. public function testClearVar(): void
  2. {
  3.     $view = new View(
  4.         $html = new Html()
  5.     );
  7.     $view->setVar('foo', 'bar');
  8.     $this->assertSame('bar', $view->getVar('foo'));
  9.     $this->assertSame('bar', $html->getVar('foo'));
  11.     $view->clearVar();
  12.     $this->assertNull($view->getVar('foo'));
  13.     $this->assertNull($html->getVar('foo'));
  14. }

display 加载视图文件

  1. public function testDisplay(): void
  2. {
  3.     $view = new View(
  4.         new Phpui([
  5.             'theme_path' => __DIR__,
  6.         ])
  7.     );
  9.     $view->setVar('foo', 'bar');
  11.     $this->assertSame(
  12.         'Hi here! bar',
  13.         $view->display(__DIR__.'/assert/hello.php')
  14.     );
  15. }

switchView 切换视图

  1. public function testSwitchView(): void
  2. {
  3.     $view = new View(
  4.         $phpui = new Phpui()
  5.     );
  7.     $view->setVar('foo', 'bar');
  8.     $this->assertSame('bar', $view->getVar('foo'));
  9.     $this->assertSame('bar', $phpui->getVar('foo'));
  11.     $view->switchView($html = new Html());
  12.     $this->assertSame('bar', $view->getVar('foo'));
  13.     $this->assertSame('bar', $html->getVar('foo'));
  14. }