开发文档 ›全部章节 ›入门 ›视图引擎怎么跑

3. 视图引擎怎么跑

第 1、2 节讲的是包里放什么文件,这一节讲这些文件在什么时候被谁调用。把这里六条规矩记住, 后面逐页拆解就不用反复解释。所有结论对着 app/core/View.php、app/core/Router.php、 app/controllers/FrontController.php 写的。

3.1 一个请求的完整路径

浏览器请求 /list/daohang.html
  1  index.php:37                          App::run()
  2  app/core/Router.php:92-127            正则表命中,转成 callFront('Front', 'cat', 参数)
  3  FrontController::cat()                认出是站点分类,转 sort();URL 不对就先 301
  4  FrontController::sort()               查库,拼一个 $data 数组
  5  app/core/View.php:63  render()        渲染 views/sort.php,$data 被 extract 成变量
  6  app/core/View.php:66-71               渲染结果塞进 $__content,再套 views/layout.php
  7  views/layout.php:91,99                头尾是片段:$this->partial('header') / partial('footer')
  8  浏览器拿到 layout 包好的完整 HTML

模板作者能动的是第 4 步往后:数据由核心拼好递给你,你只负责排版。 模板不查库是默认立场,需要多出来的数据用钩子或插件塞,别在视图里改核心查询。

3.2 当前生效的是哪一套模板

事代码在哪、怎么运作
模板名存在哪config/template.php 的 active 键,不是存数据库。出厂值 default。
谁改它后台「模板管理」点启用,TemplateController::writeActive() 直接重写这个 php 文件,只写 active、admin、mobile 三个键。
default 能不能删不能。后台拦着不让删,脚手架也不允许你占用 default 这个名字。它是所有回退的兜底。
手机模板开关config/template.php 里的 mobile 键目前核心没有任何地方读它,写了也不会自动切模板。手机端自适应靠你 CSS 里写媒体查询,这是硬要求,见 1.6。
临时改模板后台预览模板配置那次请求内部 App::setConfig() 覆盖,只活一次请求,别指望它做灰度。

3.3 视图名到文件的查找顺序

情况引擎行为
名字先清洗View::file() 把 ..、反斜杠、.php 三样从视图名里删掉。 所以 render('index') 和 render('index.php') 是同一个文件;子目录 blog/list 能进,上跳目录进不去。
先找当前模板templates/<active>/views/<名>.php,存在就用。
回退到 default不存在就直接返回 templates/default/views/<名>.php,这一层不再检查别的。 只有一层回退:不存在第三套「公共模板」目录这种东西。
两套都没有页面里输出纯文本 模板不存在:xxx.php。不是 500,不是白屏,很好认。
缺 layout.php判断在 render() 里:两套模板都没 layout 时,直接输出裸片段。 表现为页面没有 <head>、没有样式没有脚本、纯内容糊在浏览器默认样式上。别把 layout 删了试。
视图里 PHP 报错调试关着时输出 模板渲染错误:消息;把 config/app.php 的 debug 打开则直接抛出来看堆栈。

这条回退链决定了最小可交付模板:一个包只要 Dtr.php、views/index.php、 views/layout.php 三个文件就能装能用,其它页面先借 default 的顶上,回头再一套一套换掉。

3.4 数据是怎么进到变量里的

// index.php:21-23 每个前台请求都先做这两行
$conf = \DTR\Core\Config::all();
\DTR\Core\View::share('conf', $conf);   // 站点配置,dtr_config 表的 name => value
\DTR\Core\View::share('app', \DTR\Core\App::config('app'));  // config/app.php 整个数组

// app/core/View.php:108-109 渲染时
$__data = array_merge(self::$shared, $data);   // 控制器给的局部数据优先,能覆盖同名共享键
extract($__data, EXTR_SKIP);                    // 键名直接变成变量名
include $file;                                  // 所以视图里的 $this 就是 View 实例
  • 控制器给什么就有什么数组的键名 = 变量名,大小写敏感,没有的键访问就是 Undefined index。
  • 每个前台视图都能看到两个变量$conf 是全站配置表,$app 是应用配置数组。 取单个配置别用 $conf 硬取,用 tplcfg('键', 默认) 和 Config::get('键'),它们管回退。
  • 局部覆盖共享合并顺序是 array_merge(shared, data),控制器同名键赢。 你自己写插件给视图传数据时,别用 conf、app 这种键名去覆盖核心。
  • 视图里有 $thisinclude 发生在 View 类方法内部,所以 $this->partial()、 $this->wrap() 直接能用。别把视图内容抄进普通函数里跑,那一句就致命错误。

3.5 片段、包壳、以及真的想在视图里取数

// 一:渲染片段,不套布局。参数二是给片段的数据
echo $this->partial('pager', [
    'cur'    => $cur,
    'pages'  => $pages,
    'route'  => 'sort',
    'params' => ['id' => $sort['id'], 'alias' => $sort['alias']],
]);

// 二:把一段现成 HTML 用当前模板的头尾包住,插件 renderFront 就是这么出整页的
echo $this->wrap($html);

// 三:视图里想拿站点数据,随时能调模型,但别在循环里逐条查库
use DTR\Models\Sort;
$map = Sort::nameMap();          // id => name,一次查完
foreach ($rows as $r) {
    echo e($map[$r['sort_id']] ?? '—');
}

default 模板里 user.php、daishen.php、tongji.php 就直接调了模型,这是允许的,不是违规。但 tongji.php 那种在分类循环里逐条 Site::count() 的写法是 N+1 查询,分类一多后台就慢,你新写模板时先一次取完再映射。

3.6 谁渲染哪个视图

公开地址视图控制器方法
/ /index.htmlindexFrontController::index(),行 46
/index/p2.htmlindex同上。index() 不接页码参数,这一段被静默忽略,首页没有翻页
/nav.htmlnavnav(),行 66
/new.html /new/p2.htmlsortnewest(),行 86。复用列表视图,多给一个 list_route = 'newest'
/list/<分类>.html /list/<分类>/p2.htmlsortcat() 识别分类后转 sort(),行 181
/list/<分类>/<站点>.htmlsiteitem() 转 site(),行 206
/search.html?keyword=&page=searchsearch(),行 221。翻页是查询串形态,不是路径段
/about.htmlaboutabout(),行 367
/tongji.htmltongjitongji(),行 372
/apply.htmlapplyapply(),行 357。GET 展示、POST 同地址自处理
/daishen.html?page=2daishendaishen(),行 288
/login.html?r=/user.htmlloginlogin(),行 786
/register.htmlregisterregister(),行 835
/user.html /user-profile.htmluseruser($tab),行 902。tab 段只允许小写字母
/tougao.htmltougaotougao(),行 616。开关关了直接 404
/go/<id>.html不出页面行 722-740:加一次浏览量再 302 到目标站
/fav/<id>.html不出页面行 752-766:返回 JSON,未登录 401
/404.html 与所有没命中的地址404notfound(),行 956,先 http_response_code(404)

文章类与排行榜类页面的地址在第 9 节逐个讲。老地址 /site_5.html、/sort2.html、 /wz.html 这些核心会 301 到规范地址,配伪静态时别把这类规则删了;没配重写的服务器还能用 ?s=/list/daohang.html 这种形式进来。

内容有问题去论坛发帖,或直接联系老李 QQ 260468289。