登录
目录
当前位置： 首页 > 文档资料 > easySwoole 2.x 中文文档 >

HTTP基础应用 - 使用模板引擎

优质
小牛编辑
126浏览
2023-12-01

模板引擎集成

框架秉承高度自由的理念，既可以作为API框架，也可以作为常规的全站框架，开发混合式Web服务，本例介绍了如何集成当下常用的三种模板引擎，为框架集成View层，提供渲染模板视图的能力

引擎名称说明仓库地址开发参考手册
Smarty业界最着名的PHP模板引擎之一GitHub官方文档
think-templateThinkPHP 5.1 官方分离的模板引擎GitHub官方手册
BladeLaravel的模板引擎组件GitHub官方手册

引入支持库

无论使用哪个模板引擎，首先都要引入模板引擎的支持库文件，我们推荐使用 Composer 进行第三方组件包的管理，请确保已经正确安装了 Composer 然后执行下面对应的命令，引入引擎的支持库包

  1. # 使用Smarty引擎
  2. composer require smarty/smarty
  4. # 使用think-template
  5. composer require topthink/think-template
  7. # 使用Blade
  8. composer require duncan3dc/blade

第三方模板引擎支持库不属于框架的维护范围，如果遇到问题，请首先考虑升级到最新版本，如果问题无法解决，请到群里求助

建立自定义控制器抽象类

为了简化渲染页面的操作，我们需要建立一个自定义的控制器抽象类，以便自动初始化模板引擎，以及对输出方法进行封装，简化操作。下面给出的三段代码例子，分别针对不同的模板引擎，请按照自己使用的引擎参照对应的代码建立抽象控制器，请注意模板引擎都需要编译缓存目录以及模板视图目录，请提前新建好对应的目录

下面所示的例子中，视图控制器抽象类都直接存放在 APP 文件夹中，如果放在其他文件夹中，请注意命名空间，确保能自动加载到文件

Smarty

  1. <?php
  3. namespace App;
  5. use EasySwoole\Config;
  6. use EasySwoole\Core\Http\AbstractInterface\Controller;
  7. use EasySwoole\Core\Http\Request;
  8. use EasySwoole\Core\Http\Response;
  10. /**
  11.  * 视图控制器
  12.  * Class ViewController
  13.  * @author  : evalor <master@evalor.cn>
  14.  * @package App
  15.  */
  16. abstract class ViewController extends Controller
  17. {
  18.     protected $view;
  20.     /**
  21.      * 初始化模板引擎
  22.      * ViewController constructor.
  23.      * @param string   $actionName
  24.      * @param Request  $request
  25.      * @param Response $response
  26.      */
  27.     function __construct(string $actionName, Request $request, Response $response)
  28.     {
  29.         $this->view = new \Smarty();
  30.         $tempPath   = Config::getInstance()->getConf('TEMP_DIR');    # 临时文件目录
  31.         $this->view->setCompileDir("{$tempPath}/templates_c/");      # 模板编译目录
  32.         $this->view->setCacheDir("{$tempPath}/cache/");              # 模板缓存目录
  33.         $this->view->setTemplateDir(EASYSWOOLE_ROOT . '/Views/');    # 模板文件目录
  34.         $this->view->setCaching(false);
  36.         parent::__construct($actionName, $request, $response);
  37.     }
  39.     /**
  40.      * 输出模板到页面
  41.      * @param  string|null $template 模板文件
  42.      * @author : evalor <master@evalor.cn>
  43.      * @throws \Exception
  44.      * @throws \SmartyException
  45.      */
  46.     function fetch($template = null)
  47.     {
  48.         $content = $this->view->fetch($template);
  49.         $this->response()->write($content);
  50.         $this->view->clearAllAssign();
  51.         $this->view->clearAllCache();
  52.     }
  54.     /**
  55.      * 添加模板变量
  56.      * @param array|string $tpl_var 变量名
  57.      * @param mixed        $value   变量值
  58.      * @param boolean      $nocache 不缓存变量
  59.      * @author : evalor <master@evalor.cn>
  60.      */
  61.     function assign($tpl_var, $value = null, $nocache = false)
  62.     {
  63.         $this->view->assign($tpl_var, $value, $nocache);
  64.     }
  65. }

Think-Template

  1. <?php
  3. namespace App;
  5. use EasySwoole\Config;
  6. use EasySwoole\Core\Http\AbstractInterface\Controller;
  7. use EasySwoole\Core\Http\Request;
  8. use EasySwoole\Core\Http\Response;
  9. use think\Template;
  11. /**
  12.  * 视图控制器
  13.  * Class ViewController
  14.  * @author  : evalor <master@evalor.cn>
  15.  * @package App
  16.  */
  17. abstract class ViewController extends Controller
  18. {
  19.     protected $view;
  21.     /**
  22.      * 初始化模板引擎
  23.      * ViewController constructor.
  24.      * @param string   $actionName
  25.      * @param Request  $request
  26.      * @param Response $response
  27.      */
  28.     function __construct(string $actionName, Request $request, Response $response)
  29.     {
  30.         $this->view = new Template();
  31.         $tempPath   = Config::getInstance()->getConf('TEMP_DIR');     # 临时文件目录
  32.         $this->view->config([
  33.             'view_path'  => EASYSWOOLE_ROOT . '/Views/',              # 模板文件目录
  34.             'cache_path' => "{$tempPath}/templates_c/",               # 模板编译目录
  35.         ]);
  37.         parent::__construct($actionName, $request, $response);
  38.     }
  40.     /**
  41.      * 输出模板到页面
  42.      * @param  string|null $template 模板文件
  43.      * @param array        $vars     模板变量值
  44.      * @param array        $config   额外的渲染配置
  45.      * @author : evalor <master@evalor.cn>
  46.      */
  47.     function fetch($template, $vars = [], $config = [])
  48.     {
  49.         ob_start();
  50.         $this->view->fetch($template, $vars, $config);
  51.         $content = ob_get_clean();
  52.         $this->response()->write($content);
  53.     }
  54. }

Blade

  1. <?php
  3. namespace App;
  5. use EasySwoole\Config;
  6. use EasySwoole\Core\Http\AbstractInterface\Controller;
  7. use EasySwoole\Core\Http\Request;
  8. use EasySwoole\Core\Http\Response;
  9. use duncan3dc\Laravel\BladeInstance;
  11. /**
  12.  * 视图控制器
  13.  * Class ViewController
  14.  * @author  : evalor <master@evalor.cn>
  15.  * @package App
  16.  */
  17. abstract class ViewController extends Controller
  18. {
  19.     protected $view;
  21.     /**
  22.      * 初始化模板引擎
  23.      * ViewController constructor.
  24.      * @param string   $actionName
  25.      * @param Request  $request
  26.      * @param Response $response
  27.      */
  28.     function __construct(string $actionName, Request $request, Response $response)
  29.     {
  30.         $tempPath   = Config::getInstance()->getConf('TEMP_DIR');    # 临时文件目录
  31.         $this->view = new BladeInstance(EASYSWOOLE_ROOT . '/Views', "{$tempPath}/templates_c");
  33.         parent::__construct($actionName, $request, $response);
  34.     }
  36.     /**
  37.      * 输出模板到页面
  38.      * @param string $view
  39.      * @param array  $params
  40.      * @author : evalor <master@evalor.cn>
  41.      */
  42.     function render(string $view, array $params = [])
  43.     {
  44.         $content = $this->view->render($view, $params);
  45.         $this->response()->write($content);
  46.     }
  47. }

进行模板渲染

建立一个测试控制器进行模板渲染，请提前建立好模板文件，这里假设你已经有了一个index模板文件

  1. <?php
  3. namespace App\HttpController;
  5. use App\ViewController;
  7. /**
  8.  * Class Index
  9.  * @author  : evalor <master@evalor.cn>
  10.  * @package App\HttpController
  11.  */
  12. class Index extends ViewController
  13. {
  14.     function index()
  15.     {
  16.         // Blade View
  17.         $this->render('index');     # 对应模板: Views/index.blade.php
  19.         // Think-Template
  20.         $this->fetch('index');      # 对应模板: Views/index.html
  22.         // Smarty
  23.         $this->fetch('index.html'); # 对应模板: Views/index.html
  24.     }
  25. }

静态资源文件处理

由于 URL Dispatcher 的解析，直接使用 Swoole 作为HTTP服务器，在默认情况下并不能处理静态文件的返回，需要编辑全局配置文件，加入额外的配置项如下：

  1. <?php
  3. return [
  4.     'MAIN_SERVER' => [
  5.         'HOST'        => '0.0.0.0',
  6.         'PORT'        => 9501,
  7.         'SERVER_TYPE' => \EasySwoole\Core\Swoole\ServerManager::TYPE_WEB_SERVER,
  8.         'SOCK_TYPE'   => SWOOLE_TCP,
  9.         'RUN_MODEL'   => SWOOLE_PROCESS,
  10.         'SETTING'     => [
  11.             'worker_num'            => 8,     // worker进程
  12.             'max_request'           => 5000,  // 执行5000次后重启worker进程
  13.             'task_worker_num'       => 8,     // 异步任务进程
  14.             'task_max_request'      => 10,    // 执行10次后重启task进程
  15.             // 加入以下两条配置以返回静态文件
  16.             'document_root'         => EASYSWOOLE_ROOT.'/Public',  // 静态资源目录
  17.             'enable_static_handler' => true,
  18.         ],
  19.     ]
  21.     // 以下配置省略.......
  22. ];

注意静态资源目录需要提前新建好 改为自己的目录 ！！！不要直接复制！！！

前端服务器

由于 Swoole Server 对 HTTP 协议的支持并不完整，建议仅将 EasySwoole 作为后端服务，并且在前端增加 NGINX 或 APACHE 作为代理，参照下面的例子添加转发规则

NGINX

  1. server {
  2.     root /data/wwwroot/;
  3.     server_name local.swoole.com;
  4.     location / {
  5.         proxy_http_version 1.1;
  6.         proxy_set_header Connection "keep-alive";
  7.         proxy_set_header X-Real-IP $remote_addr;
  8.         if (!-e $request_filename) {
  9.              proxy_pass http://127.0.0.1:9501;
  10.         }
  11.     }
  12. }

APACHE

  1. <IfModule mod_rewrite.c>
  2.   Options +FollowSymlinks
  3.   RewriteEngine On
  4.   RewriteCond %{REQUEST_FILENAME} !-d
  5.   RewriteCond %{REQUEST_FILENAME} !-f
  6.   #RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]  fcgi下无效
  7.   RewriteRule ^(.*)$  http://127.0.0.1:9501/$1 [QSA,P,L]
  8.    #请开启 proxy_mod proxy_http_mod request_mod
  9. </IfModule>
免责声明： 以上内容版权归原作者所有，如有侵犯您的原创版权请告知，我们将尽快删除相关内容。感谢每一位辛勤著写的作者，感谢每一位的分享。
@小牛知识库 xnip.cn