easyswoole/template

An efficient swoole framework

1.2.0 2024-04-16 02:59 UTC

This package is auto-updated.

Last update: 2024-12-16 04:42:02 UTC


README

实现原理

注册N个自定义进程做渲染进程,进程内关闭协程环境,并监听UNIXSOCK,客户端调用携程的client客户端发送数据给进程渲染,进程再返回结果给客户端,用来解决PHP模板引擎协程安全问题。可以实现渲染接口,根据自己的喜好引入smarty或者是blade或者是其他引擎.

引入模板引擎类

下面列举一些常用的模板引擎包方便引入使用:

smarty/smarty

Smarty是一个使用PHP写出来的模板引擎,是目前业界最著名的PHP模板引擎之一

composer require smarty/smarty=~3.1

league/plates

使用原生PHP语法的非编译型模板引擎,更低的学习成本和更高的自由度

composer require league/plates=3.*

duncan3dc/blade

Laravel框架使用的模板引擎

composer require duncan3dc/blade=^4.5

topthink/think-template

ThinkPHP框架使用的模板引擎

composer require topthink/think-template

渲染模板

选择一个心仪的模板引擎,并实现RenderInterface接口,当进程收到一条渲染指令时,会调用该实现类的render方法进行渲染,渲染结束后调用afterRender方法,可在此处进行变量释放清理等操作,以Smarty引擎为例,创建一个渲染器, 并渲染的最小例子如下

用Smarty作为渲染器

<?php
use EasySwoole\Template\Render;
use EasySwoole\Template\RenderInterface;

require 'vendor/autoload.php';

class MyRender implements RenderInterface{

    public function render(string $template, ?array $data = null, ?array $options = null): ?string
    {
        return "your template is {$template} and data is ".json_encode($data);
    }

    public function onException(\Throwable $throwable, $arg): string
    {
        return $throwable->getTraceAsString();
    }
}
Render::getInstance()->getConfig()->setRender(new MyRender());

$http = new swoole_http_server("0.0.0.0", 9501);
$http->on("request", function ( $request,  $response){
    $ret = Render::getInstance()->render('index.html',['easyswoole'=>'hello']);
    $response->end($ret);
});

Render::getInstance()->attachServer($http);

$http->start();

启动测试服务器

代码包内置了一个小型的测试服务器,在tests目录下,支持smarty、plates、blade、think四种引擎的快速测试,使用下方代码启动,访问 http://127.0.0.1:9501 即可查看输出,对应的模板文件在test/TemplateViews目录下,可以修改这些模板来测试功能

cd tests
php testServer.php -e 模板引擎名称