ThinkPHP视图怎么引入公共头部_ThinkPHP模板include复用介绍【介绍】-ThinkPHP-PHP中文网

thinkphp 6 中引入公共头部应使用 {include file="common/header"}，路径基于 view_path 配置、不支持 ./ 或 ../；变量需显式传递或通过 assign="true" 继承；{block} 在 include 中无效；修改后需清理模板缓存生效。

thinkphp视图怎么引入公共头部_thinkphp模板include复用介绍【介绍】

ThinkPHP 的视图中引入公共头部，最直接有效的方式是用 include 标签，但必须注意路径写法、变量作用域和模板引擎行为——否则会报错或渲染空白。

ThinkPHP 6 默认使用 ThinkTemplate 引擎，include 的 file 参数不支持相对路径（比如 ./header.html），也不推荐硬写完整路径。正确写法是基于 view_path 配置的相对路径：

公共头部放在 app/view/common/header.html，就在任意模板里写 {include file="common/header"}
如果在子目录如 app/view/admin/index.html 中引用，仍用 {include file="common/header"}，不是 ../common/header
后缀 .html 可省略，但加上更明确；若模板后缀配置为 php，则需对应写 common/header.php
路径中不能含 ./ 或 ../，否则解析失败，返回空内容且无报错提示

ThinkPHP 的 include 默认是“局部作用域”，子模板（如 header）无法直接访问父模板传入的数据，除非显式传递：

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

直接传参： {include file="common/header" title="$title" user="$user"}，子模板就能用 $title
全量继承当前作用域（慎用）：加 assign 属性 {include file="common/header" assign="true"}，但会导致变量污染，尤其在嵌套 include 时难调试
更稳妥的做法是统一用 View::assign() 在控制器中预设公共变量（如 site_name、nav_list），再在 header.html 中直接使用

不能。ThinkPHP 的 {block} / {extend} 是布局继承机制，只在顶层模板（被 fetch() 渲染的那个）中生效；include 是纯内容拼接，不触发继承解析：

如果在 common/header.html 里写了 {block name="title"}默认标题{/block}，它不会被父模板中的 {block name="title"}首页{/block} 替换
想实现类似效果，得改用 {extend name="layout/master"} + {block} 方式重构结构，把 header 放进 layout 模板里，而非靠 include
混用 include 和 extend 容易导致逻辑混乱，建议二选一：简单复用用 include，复杂布局统一用 extend

真正容易被忽略的是缓存行为：include 的文件修改后，若开启了模板缓存（默认开启），可能不会立即生效——需要清空 runtime/view/ 目录，或者临时关闭 template.cache 配置调试。