PHPackages githen/cmsengine - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Templating & Views](/categories/templating) 4. / 5. githen/cmsengine ActiveLibrary[Templating & Views](/categories/templating) githen/cmsengine ================ CMS生成HTML模板引擎 v1.0.3(7mo ago)1302MITPHP Since Apr 25Pushed 7mo agoCompare [ Source](https://github.com/jiaoyu-cn/cmsengine)[ Packagist](https://packagist.org/packages/githen/cmsengine)[ RSS](/packages/githen-cmsengine/feed)WikiDiscussions master Synced today READMEChangelogDependencies (1)Versions (5)Used By (0) CMS模板生成扩展 ========= [](#cms模板生成扩展) 这是一个基于laravel框架，为CMS模板引擎生成HTML实现的扩展包。 支持对属性值，列表自定义标签。 [![image](https://camo.githubusercontent.com/b862f6b889e4991ad223a297ec7072bf9a1548d07fca8c1832c96b5a7f3fdfb8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f67697468656e2d636e2f636d73656e67696e65)](https://github.com/githen-cn/cmsengine/stargazers)[![image](https://camo.githubusercontent.com/f27b4feefe1ee4629546f99aae07f7ab9fdee43677f8a29f32d9603d5b8ae580/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f67697468656e2d636e2f636d73656e67696e65)](https://github.com/githen-cn/cmsengine/network/members)[![image](https://camo.githubusercontent.com/c1889d15b516cfebab6ff5c0ebf510b120cbe1fad5862941c75eae0a08f5b9e7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f67697468656e2d636e2f636d73656e67696e65)](https://github.com/githen-cn/cmsengine/issues) 安装 -- [](#安装) ``` composer require githen/cmsengine # 迁移配置文件 php artisan vendor:publish --provider="Githen\CmsEngine\CmsProvider" ``` 配置文件说明 ------ [](#配置文件说明) ``` return [ // 基础配置 'config' => [ 'namespace' => 'eol', // 标记名 'tagstart' => '{', // 标记开始符 'tagend' => '}', // 标记结束符 'tagmaxlen' => 60, // 标签名最长长度 'tolow' => TRUE, // 标签大小写不敏感 'home' => storage_path('template'), // 模板根目录 'disk' => 'local', // 存储引擎 'include_deep' => 3, // 默认3级 ], // 标签白名单，只有在此定义才可解析通过 // type 目前有三种 field(属性值)，list(列表), page(分页) // taget 实现类，通过 app('cms.field') 方式调用出来 'tags' => [ 'site' => ['type' => 'field', 'taget' => 'cms.field'], 'school' => ['type' => 'field', 'taget' => 'cms.field'], 'arclist' => ['type' => 'list', 'taget' => 'cms.list'], 'page' => ['type' => 'page', 'taget' => 'cms.page'], ], ]; ``` 标签说明 ---- [](#标签说明) 目前标签解析支持三种方式： 1. 获取属性值 > {eol:tag.title/} > > {eol:tag name="title"/} 2. 对列表/分页进行渲染 > {eol:arclist id=1 row=60 order='desc'} > > <li>\[field:title/\]</li> > > {/eol:tag} 3. 内置标签 - include > 标签举例 > > {eol:include filename='footer.html'/} > > 引擎将会把 app('html.tpl')中 $homeDir/footer.html进行渲染生成html替换此标签 - foreach > 数据遍历 > > {eol:foreach array="field:category"} > > \[field:key/\] -- \[field:val/\] > > {/eol:foreach} > > array: 需要遍历的数组 > > 1. 支持数组索引的方式调用 \[field:index/\] > 2. 使用内置标签,前提是数组中不存在 key/val 两个索引 > > > \[field:key/\]：获取数组索引 > > > > \[field:val/\]：获取数组值（字符串，整形） - global > 全局定义的属性 > > {eol:global.page\_total/} // 总条数 > > {eol:global.page\_size/} // 每页数据 > > {eol:global.page\_num/} // 总页数 > > {eol:global.page\_index/} // 当前页数 > > {eol:global.page\_url/} // 分页规则 > > {eol:global.domain/} // 静态资源域名 > > {eol:global.tplid/} // 模板id > > {eol:global.resource\_url/} // 静态资源调用地址 > > {eol:global.build\_time/} // 构建时间 > > 注：此地址是将domain和tplid进行组装，若tplid未设置或为0，则不拼接 > > $domain = ''; > > $tplid = 0 > > 则$resource\_url 为 '' > > 若$tplid = 10 或 $tplid = 'addd' > > 则$resource\_url 为 '' 或 '' 4. 标签处理方法 - 针对每个标签，支持扩展方法对数据进行处理，格式如下 ``` {eol:global.resource_url function='limit(@, 10, ...)' /} ``` - 引擎已内置了部分数据处理的方法如下 ``` 说明 ：限长处理 举例：limit(@, 3, '...') 参数说明:第一个： @ 固定写法，执行时被替换为实际值 第二个： 最长长度，非必填，默认15 第三个：截断后追加字符，非必填，默认... ``` - 扩展方法 内置方法不足以满足数据处理或其它需求时，支持扩展自定义的方法，可在模板进行fetch或saveTo的时候，通过注入类的方式实现，代码如下： ``` $tpl = clone app('html.tpl'); // 参数支持类名或实例化后的类 // 若标签标记的方法名为abc, {eol:global.resource_url function='abc(@)' /} // 那么在此类中必须有abc方法，并且参数要兼容模板中配置的abc的参数 $tpl->->setFunctions(Functions::class); ``` 使用举例 ---- [](#使用举例) ### 项目中调用 [](#项目中调用) ``` $tpl = clone app('html.tpl'); $tpl->setNameSpace('eol', '{', '}')->loadTemplate('index.html'); // 获取渲染后的html $html = $tpl->fetch(); // 渲染后的html直接保存到文件() // 需要在config/filesystems.php中声明 cms.php中定义 的 disk 驱动 $tpl->saveTo('index.html'); //分页调用,直接返回需要页面的html代码 $html = $tpl->fetch(2); // 遍历生成文件, {page}将会生成对应的页码数， // 如果存在第二个参数，则首页的文件将为此参数的值，其它页的文件名不变 $tpl->saveTo('aa/list{page}.html', 'new.html'); ``` ### 注册自定义数据服务提供者 [](#注册自定义数据服务提供者) ``` // 数据获取服务提供者，自我声明服务提供者，并在config/app.php中加载 /** * Register services. * * @return void */ public function register() { // 注册服务方式 $this->app->singleton('cms.field', function ($app) { return new Fields(); }); $this->app->singleton('cms.list', function ($app) { return new Lists(); }); $this->app->singleton('cms.page', function ($app) { return new Pages(); }); } ``` ### 取数据值实例 [](#取数据值实例) 在`config/cms.php`中的`tags`中，声明的标签`type`为`field`时，会自动调用此类，标签名为类中的方法名。 ``` class Fields { /** * 缓存数据 */ private $cache; /** * @param $tag * @param $linkData */ public function data($tag, $linkData) { // 获取标签指定数据 return $this->{$tag->tagName}($tag, $linkData); } /** * 获取值数据，直接填充 */ private function site($tag, $linkData) { // 获取站点缓存类 $cacheKey = $linkData['site_id'].'.site'; if(! $site = data_get($this->cache, $cacheKey, false)){ $site = Site::select('name','school_id', 'domain', 'title', 'keywords', 'description')->where('id', $linkData['site_id'])->first(); data_set($this->cache, $cacheKey, $site); dump("查询了下site:".$linkData['site_id']); } return $site->{$tag->getAttribute('name')}; } } ``` ### 获取列表实例 [](#获取列表实例) 在`config/cms.php`中的`tags`中，声明的标签`type`为`list`时，会自动调用此类，标签名为类中的方法名。 ``` class Lists { /** * 缓存数据 */ private $cache; /** * @param $tag * @param $linkData */ public function data($tag, $linkData) { // 获取标签指定数据 return $this->{$tag->tagName}($tag, $linkData); } /** * 获取列表数据 * */ private function arclist($tag, $linkData) { // 必要参数检测 // code ... // 获取站点缓存类 $unikey = "{$tag->getAttribute('id')}_{$tag->getAttribute('row')}"; $cacheKey = $linkData['site_id'].'.arclist.'.$unikey; if(! $arclist = data_get($this->cache, $cacheKey, false)){ $arclist = News::select('type','title', 'cover', 'content', 'created_at', 'description')->where('category_id', $tag->getAttribute('id'))->limit($tag->getAttribute('row'))->get(); data_set($this->cache, $cacheKey, $arclist); dump("查询了下栏目id为".$tag->getAttribute('id').'下面的文章，site_news'); } return $arclist->toArray(); } } ``` ### 获取分页实例 [](#获取分页实例) 在`config/cms.php`中的`tags`中，声明的标签`type`为`page`时，会自动调用此类，标签名为类中的方法名。 分页中若展示页码，可通过`global`获取分页信息，通过`js`渲染 ```