视圖

webman預設使用的是php原生語法作為模板，在打開opcache後具有最佳效能。除了php原生模板，webman還提供了Twig、 Blade、 think-template 模板引擎。

開啟opcache

使用視圖時，強烈建議開啟php.ini中opcache.enable和opcache.enable_cli 兩個選項，以便模板引擎達到最佳效能。

安裝Twig

1、composer安裝

composer require twig/twig

2、修改配置config/view.php為

<?php
use support\view\Twig;

return [
    'handler' => Twig::class
];

提示
其它配置選項通過options傳入，例如

return [
    'handler' => Twig::class,
    'options' => [
        'debug' => false,
        'charset' => 'utf-8'
    ]
];

安裝Blade

1、composer安裝

composer require psr/container ^1.1.1 webman/blade

2、修改配置config/view.php為

<?php
use support\view\Blade;

return [
    'handler' => Blade::class
];

安裝think-template

1、composer安裝

composer require topthink/think-template

2、修改配置config/view.php為

<?php
use support\view\ThinkPHP;

return [
    'handler' => ThinkPHP::class,
];

提示
其它配置選項通過options傳入，例如

return [
    'handler' => ThinkPHP::class,
    'options' => [
        'view_suffix' => 'html',
        'tpl_begin' => '{',
        'tpl_end' => '}'
    ]
];

原生PHP模板引擎例子

創建檔案 app/controller/UserController.php 如下

<?php
namespace app\controller;

use support\Request;

class UserController
{
    public function hello(Request $request)
    {
        return view('user/hello', ['name' => 'webman']);
    }
}

新建檔案 app/view/user/hello.html 如下

<!doctype html>
<html>
<head>
    <meta charset="utf-8">
    <title>webman</title>
</head>
<body>
hello <?=htmlspecialchars($name)?>
</body>
</html>

Twig模板引擎例子

修改配置config/view.php為

<?php
use support\view\Twig;

return [
    'handler' => Twig::class
];

app/controller/UserController.php 如下

<?php
namespace app\controller;

use support\Request;

class UserController
{
    public function hello(Request $request)
    {
        return view('user/hello', ['name' => 'webman']);
    }
}

檔案 app/view/user/hello.html 如下

<!doctype html>
<html>
<head>
    <meta charset="utf-8">
    <title>webman</title>
</head>
<body>
hello {{name}}
</body>
</html>

更多文檔參考 Twig

Blade 模板的例子

修改配置config/view.php為

<?php
use support\view\Blade;

return [
    'handler' => Blade::class
];

app/controller/UserController.php 如下

<?php
namespace app\controller;

use support\Request;

class UserController
{
    public function hello(Request $request)
    {
        return view('user/hello', ['name' => 'webman']);
    }
}

檔案 app/view/user/hello.blade.php 如下

注意blade模板後綴名為.blade.php

<!doctype html>
<html>
<head>
    <meta charset="utf-8">
    <title>webman</title>
</head>
<body>
hello {{$name}}
</body>
</html>

更多文檔參考 Blade

ThinkPHP 模板的例子

修改配置config/view.php為

<?php
use support\view\ThinkPHP;

return [
    'handler' => ThinkPHP::class
];

app/controller/UserController.php 如下

<?php
namespace app\controller;

use support\Request;

class UserController
{
    public function hello(Request $request)
    {
        return view('user/hello', ['name' => 'webman']);
    }
}

檔案 app/view/user/hello.html 如下

<!doctype html>
<html>
<head>
    <meta charset="utf-8">
    <title>webman</title>
</head>
<body>
hello {$name}
</body>
</html>

更多文檔參考 think-template

模板賦值

除了使用view(模板, 變量數組)給模板賦值，我們還可以在任意位置通過調用View::assign()給模板賦值。例如：

<?php
namespace app\controller;

use support\Request;
use support\View;

class UserController
{
    public function hello(Request $request)
    {
        View::assign([
            'name1' => 'value1',
            'name2'=> 'value2',
        ]);
        View::assign('name3', 'value3');
        return view('user/test', ['name' => 'webman']);
    }
}

View::assign()在某些場景下非常有用，例如某系統每個頁面首部都要顯示當前登錄者信息，如果每個頁面都將此信息通過 view('模板', ['user_info' => '用戶信息']); 賦值將非常麻煩。解決辦法就是在中間件中獲得用戶信息，然後通過View::assign()將用戶信息賦值給模板。

關於視圖檔案路徑

控制器

當控制器調用view('模板名',[]);時，視圖檔案按照如下規則查找：

/開頭則直接使用該路徑查找視圖檔案
不是以/開頭並且非多應用時，使用 app/view/ 下對應的視圖檔案
不是以/開頭並且是多應用時，使用 app/應用名/view/ 下對應的視圖檔案
如果不傳模板參數，自動根據2 3規則查找模板檔案

例子：

<?php
namespace app\controller;

use support\Request;

class UserController
{
    public function hello(Request $request)
    {
        // 等價於 return view('user/hello', ['name' => 'webman']);
        // 等價於 return view('/app/view/user/hello', ['name' => 'webman']);
        return view(['name' => 'webman']);
    }
}

閉包函數

閉包函數$request->app 為空，不屬於任何應用，所以閉包函數使用app/view/下的視圖檔案，例如 config/route.php 裡定義路由

Route::any('/admin/user/get', function (Reqeust $reqeust) {
    return view('user', []);
});

會使用app/view/user.html作為模板檔案（當使用blade模板時模板檔案為app/view/user.blade.php）。

指定應用

為了多應用模式下模板可以重用，view($template, $data, $app = null) 提供了第三個參數 $app，可以用來指定使用哪個應用目錄下的模板。例如 view('user', [], 'admin'); 會強制使用 app/admin/view/ 下的視圖檔案。

省略模板參數

在類的控制器裡可以省略模板參數，例如

<?php
namespace app\controller;

use support\Request;

class UserController
{
    public function hello(Request $request)
    {
        // 等價於 return view('user/hello', ['name' => 'webman']);
        // 等價於 return view('/app/view/user/hello', ['name' => 'webman']);
        return view(['name' => 'webman']);
    }
}

擴展twig

我們可以通過給配置view.extension回調，來擴展twig視圖實例，例如config/view.php如下

<?php
use support\view\Twig;
return [
    'handler' => Twig::class,
    'extension' => function (\Twig\Environment $twig) {
        $twig->addExtension(new your\namespace\YourExtension()); // 增加Extension
        $twig->addFilter(new \Twig\TwigFilter('rot13', 'str_rot13')); // 增加Filter
        $twig->addFunction(new \Twig\TwigFunction('function_name', function () {})); // 增加函數
    }
];

擴展blade

同樣的我們可以通過給配置view.extension回調，來擴展blade視圖實例，例如config/view.php如下

<?php
use support\view\Blade;
return [
    'handler' => Blade::class,
    'extension' => function (Jenssegers\Blade\Blade $blade) {
        // 給blade添加指令
        $blade->directive('mydate', function ($timestamp) {
            return "<?php echo date('Y-m-d H:i:s', $timestamp); ?>";
        });
    }
];

blade使用component組件

假設需要添加一個Alert組件

新建 app/view/components/Alert.php

<?php

namespace app\view\components;

use Illuminate\View\Component;

class Alert extends Component
{

    public function __construct()
    {

    }

    public function render()
    {
        return view('components/alert')->rawBody();
    }
}

新建 app/view/components/alert.blade.php

<div>
    <b style="color: red">hello blade component</b>
</div>

/config/view.php類似如下代碼

<?php
use support\view\Blade;
return [
    'handler' => Blade::class,
    'extension' => function (Jenssegers\Blade\Blade $blade) {
        $blade->component('alert', app\view\components\Alert::class);
    }
];

至此，Blade組件Alert設定完畢，模板裡使用時類似如下

<!doctype html>
<html>
<head>
    <meta charset="utf-8">
    <title>webman</title>
</head>
<body>

<x-alert/>

</body>
</html>

擴展think-template

think-template 使用view.options.taglib_pre_load來擴展標籤庫，例如

<?php
use support\view\ThinkPHP;
return [
    'handler' => ThinkPHP::class,
    'options' => [
        'taglib_pre_load' => your\namspace\Taglib::class,
    ]
];

詳情參考 think-template標籤擴展