视图(View)负责把控制器的数据渲染成 HTML 页面。官方手册《视图》一章下设多个子类:模板渲染、模板赋值、视图配置、模板布局、视图助手。本文逐一整理,结尾附综合小实例。参考:ThinkPHP 8 视图。
一、模板渲染
控制器里 return view() 即渲染模板,模板文件默认放在 app/view 目录:
use thinkfacadeView;
return view(); // 自动渲染当前控制器/操作对应的模板
return view('blog/detail'); // 指定模板 app/view/blog/detail.html
return view('blog/detail', ['id' => 10]); // 模板 + 数据
View::assign('name', 'tp');
return View::fetch('blog/detail'); // 视图类写法
模板路径规则:控制器名/方法名,目录分隔符由 view_depr 配置决定。
二、模板赋值
View::assign('name', 'thinkphp'); // 单个赋值
View::assign(['name' => 'tp', 'ver' => 8]); // 批量赋值
return view('blog/detail', ['id' => 10]); // fetch 的第二参数也能传数据
模板里用 {$name} 输出变量;数组用 {$article.title},对象用 {$user.name}。
三、视图配置(config/view.php)
// config/view.php
return [
'type' => 'think', // 模板引擎(可换 php 原生等)
'view_suffix' => 'html', // 模板文件后缀
'view_depr' => DS, // 模板目录分隔符
'tpl_cache' => true, // 模板编译缓存(生产必开)
'tpl_replace_string' => [
'__STATIC__' => '/static', // 批量替换:模板里的静态资源占位符
],
];
tpl_replace_string 是常用技巧:模板里写 __STATIC__/css/app.css,渲染时自动替换为真实路径,换 CDN 只改配置。
四、模板布局
布局用一个公共模板包裹所有页面的头尾,避免每页重复写:
// config/view.php 开启布局
'layout_on' => true,
'layout_name' => 'layout',
'layout_item' => '{__CONTENT__}',
<!-- app/view/layout.html -->
<!DOCTYPE html>
<html>
<head><title>{$title|htmlspecialchars}</title></head>
<body>
{__CONTENT__}
</body>
</html>
渲染时页面内容自动嵌入 {__CONTENT__} 位置;也可以在某个模板里用布局标签临时开启,灵活控制个别页面。
五、视图助手与模板语法衔接
- 模板里生成地址:
{:url('blog/read',['id'=>1])},跟随路由规则 - 输出变量:
{$name};带过滤器:{$title|htmlspecialchars};原样输出 HTML:{$article.content|raw} - 直接执行 PHP 表达式:
{:date('Y-m-d', $article.create_time)} - 更完整的模板标签语法(if、volist、extend/block 继承等)属于《模板引擎》一章,写复杂页面时再深入
六、综合小实例:博客详情页
把渲染、赋值、布局、助手串起来:
// 控制器 app/controller/Blog.php
use thinkfacadeView;
public function detail($id)
{
$article = Db::name('article')->find($id);
View::assign('article', $article);
View::assign('title', $article['title']); // 给布局的标题用
return view('blog/detail');
}
<!-- 模板 app/view/blog/detail.html -->
<h1>{$article.title|htmlspecialchars}</h1>
<p>发布时间:{:date('Y-m-d', $article.create_time)}</p>
<div class="content">{$article.content|raw}</div>
<p><a href="{:url('blog/index')}">返回列表</a></p>
页面内容最终嵌进 layout.html 的 {__CONTENT__},全站头尾统一;标题经 $title 传给布局输出 —— 一个详情页用齐了模板渲染、模板赋值、视图配置(替换占位符)、布局和视图助手。
七、总结
return view() 渲染、assign/fetch 传数据;config/view.php 管引擎、后缀、缓存、静态占位替换;layout + {__CONTENT__} 统一头尾;模板里 url() 生成地址、|raw 控制转义;复杂标签语法留给模板引擎章节。