技术 · 思考 · 实践 · 成长

首页/ThinkPHP8/正文

ThinkPHP 8 视图完全指南:模板渲染、赋值、视图配置与布局

ThinkPHP87 次阅读

视图(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 控制转义;复杂标签语法留给模板引擎章节。

人生在世,不如意事十之八九;人生的滋味,哪怕是酸甜或苦辣,也要靠自己去品。人活一口气:气质看一个人的过去,气度看一个人的未来

评论交流

0 条评论 · 支持多级回复
验证码
暂无评论,来说说你的想法吧

相关文章

继续阅读