ThinkPHP模板布局_公共头部和底部引入方法【详解】-php教程-PHP中文网

{include}最快但路径易错，{extend}+{block}更清晰可维护；thinkphp中{include}路径须为模板目录下相对路径，如“public/header”，不支持./或../，传参需显式声明，静态资源路径须用{__static__}前缀。

thinkphp模板布局_公共头部和底部引入方法【详解】

直接说结论：用 {include} 最快，但路径写错就白忙；想结构清晰、可维护性强，该上 {extend} + {block} 布局机制。

90% 的引入失败，根源在路径不是「模板目录下的相对路径」。ThinkPHP 不认 ./、../，也不走 PHP 的 include_path。

{include file="public/header"} → 对应 view/public/header.html（推荐，简洁明确）
{include file="/common/footer"} → 从 view/ 根目录开始找，即 view/common/footer.html（绝对路径写法，适合跨子目录复用）
{include file="admin@public/header"} → 引入 view/admin/public/header.html（仅当 admin 是有效模块名时生效）
别写 {include file="./header"} 或 {include file="header.html"} —— 这两种都会去当前模板同级目录找，极易返回空白且无报错提示
后缀 .html 可省略，但显式写出更防错；若你把模板后缀设为 .php，就得写成 common/header.php

{include} 默认是局部作用域，父模板的 $title、$user 在被包含模板里直接访问不到——这不是 bug，是设计行为。

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

下载

显式传参最安全：{include file="public/header" title="首页" is_login=1 user_name=$user.name}，子模板里就能用 {$title}、{$user_name}
不支持 PHP 数组字面量：{include file="public/header" data="['title'=>'首页']"} 会直接忽略，不报错也不解析
复杂数据建议提前 assign：$this->assign('header_data', $data)，再 {include file="public/header" header_data=$header_data}
慎用 assign="true"：{include file="public/header" assign="true"} 会全量继承父作用域，嵌套多层 include 时变量污染难排查

这不是 {include} 的问题，而是 HTML 资源路径相对于当前请求 URL 解析导致的。include 只做字符串拼接，不会自动修正 <link href="css/app.css"> 这类相对路径。

静态资源一律用 {__static__} 动态前缀：<link href="%7B__static__%7D/css/app.css">
如果用了域名或 CDN，确保 __static__ 在配置中已正确设置（如 'view_replace_str' => ['__static__' => '/static']）
不要在 header.html 里写 <script src="./js/main.js"></script> —— ./ 会相对于当前页面 URL，而不是模板位置
检查浏览器开发者工具 Network 面板，确认 404 请求的真实路径，反推 {__static__} 是否漏配或路径层级错位

技术上可以，逻辑上容易混乱。二者定位不同：{include} 是内容复用，{extend} 是结构继承。

{block} 在 {include} 进来的模板里完全无效 —— 它只在被 fetch() 渲染的顶层模板中解析
比如你在 common/header.html 里写了 {block name="title"}默认{/block}，它不会被父模板的 {block name="title"}首页{/block} 替换
想实现区块替换效果，必须改用布局方式：{extend name="layout/master"}，然后在 layout/master.html 里 {include file="common/header"}，再用 {__CONTENT__} 插入主体
简单项目用 {include} 快；中大型项目或需多级定制（如后台/前台不同头部），优先用 {extend} 统一管理结构