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.html | index | FrontController::index(),行 46 |
/index/p2.html | index | 同上。index() 不接页码参数,这一段被静默忽略,首页没有翻页 |
/nav.html | nav | nav(),行 66 |
/new.html /new/p2.html | sort | newest(),行 86。复用列表视图,多给一个 list_route = 'newest' |
/list/<分类>.html /list/<分类>/p2.html | sort | cat() 识别分类后转 sort(),行 181 |
/list/<分类>/<站点>.html | site | item() 转 site(),行 206 |
/search.html?keyword=&page= | search | search(),行 221。翻页是查询串形态,不是路径段 |
/about.html | about | about(),行 367 |
/tongji.html | tongji | tongji(),行 372 |
/apply.html | apply | apply(),行 357。GET 展示、POST 同地址自处理 |
/daishen.html?page=2 | daishen | daishen(),行 288 |
/login.html?r=/user.html | login | login(),行 786 |
/register.html | register | register(),行 835 |
/user.html /user-profile.html | user | user($tab),行 902。tab 段只允许小写字母 |
/tougao.html | tougao | tougao(),行 616。开关关了直接 404 |
/go/<id>.html | 不出页面 | 行 722-740:加一次浏览量再 302 到目标站 |
/fav/<id>.html | 不出页面 | 行 752-766:返回 JSON,未登录 401 |
/404.html 与所有没命中的地址 | 404 | notfound(),行 956,先 http_response_code(404) |
文章类与排行榜类页面的地址在第 9 节逐个讲。老地址 /site_5.html、/sort2.html、
/wz.html 这些核心会 301 到规范地址,配伪静态时别把这类规则删了;没配重写的服务器还能用
?s=/list/daohang.html 这种形式进来。
内容有问题去论坛发帖,或直接联系老李 QQ 260468289。