ThinkPHP的模板包含怎么用？ThinkPHP如何引入子模板？-ThinkPHP-PHP中文网

thinkphp中引入子模板最直接的方式是使用{include file="path/to/template" /}标签，适用于公共组件的复用，如头部、底部等；2. 对于统一页面布局，则使用{extend name="layout" /}结合{block}{/block}实现模板继承，子模板通过定义block替换布局中的对应区块；3. 模板包含时，默认情况下父模板的所有变量自动传递给子模板，无需额外传递，但需注意变量命名避免冲突；4. 性能方面，thinkphp模板引擎会将包含的模板编译为单一php文件，后续请求直接执行编译结果，因此实际运行时性能开销小，优化重点应放在确保缓存目录可写、生产环境关闭调试模式及避免在模板中执行复杂逻辑。该机制通过组件化和布局继承提升代码复用性与维护效率，是构建中大型项目的有效手段。

ThinkPHP的模板包含怎么用？ThinkPHP如何引入子模板？

ThinkPHP中引入子模板，最直接的方式就是使用{include file="path/to/template" /}标签。它允许你把一个独立的小模板文件内容，比如一个通用的头部、底部导航或者一个评论框，直接插入到当前模板的任何位置。这就像搭积木一样，把零散的模块拼成一个完整的页面，极大地提升了代码的复用性和维护效率。而对于更宏观的页面结构，比如整个网站的统一布局，ThinkPHP则提供了{extend name="layout" /}和{block name="content"}{/block}的组合，这是一种更强大的布局继承机制。

解决方案

在ThinkPHP的模板引擎中，实现模板的包含（引入子模板）主要依赖于两种机制：include标签和extend/block标签。

1. 使用{include file="template_name" /}进行组件化包含：

立即学习“PHP免费学习笔记（深入）”；

这是最常见的子模板引入方式，适用于将一些独立的、可复用的UI组件或内容片段嵌入到主模板中。

基本用法： 假设你有一个header.html文件（位于application/index/view/public/header.html），里面包含了网站的顶部导航和Logo。你可以在任何需要显示头部的主模板中这样引入：

<!-- application/index/view/index/index.html -->
<!DOCTYPE html>
<html>
<head>
    <title>我的网站</title>
    <link rel="stylesheet" href="/static/css/main.css">
</head>
<body>
    {include file="public/header" /}

    <div class="content">
        <h1>欢迎来到首页！</h1>
        <p>这里是页面的主要内容。</p>
    </div>

    {include file="public/footer" /}
</body>
</html>

登录后复制

对应的header.html可能长这样：

<!-- application/index/view/public/header.html -->
<header class="main-header">
    <div class="logo">网站Logo</div>
    <nav>
        <ul>
            <li><a href="/">首页</a></li>
            <li><a href="/about">关于我们</a></li>
            <li><a href="/contact">联系方式</a></li>
        </ul>
    </nav>
</header>

登录后复制

路径解析：file属性的值是相对于当前模块的view目录的路径。例如，如果你在application/index/view/index/index.html中引入public/header，系统会去application/index/view/public/header.html寻找。你也可以使用绝对路径，例如@app/index/view/public/header.html，但这通常不推荐，因为不够灵活。

2. 使用{extend name="layout_name" /}和{block name="block_name"}{/block}进行布局继承：

这种方式更适合构建统一的页面骨架，例如一个后台管理系统的整体框架，或者一个博客网站的通用布局。你定义一个基础布局文件，然后子页面只需要填充特定的内容块。

定义基础布局文件：

<!-- application/index/view/layout/base.html -->
<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>{block name="title"}默认标题{/block}</title>
    <link rel="stylesheet" href="/static/css/base.css">
    {block name="css"}{/block}
</head>
<body>
    <div class="wrapper">
        <header class="site-header">
            <h1>我的网站后台</h1>
        </header>

        <aside class="sidebar">
            {block name="sidebar"}
                <ul>
                    <li><a href="#">仪表盘</a></li>
                    <li><a href="#">用户管理</a></li>
                </ul>
            {/block}
        </aside>

        <main class="content-area">
            {block name="content"}{/block}
        </main>

        <footer class="site-footer">
            <p>&copy; 2023 我的网站</p>
        </footer>
    </div>
    {block name="js"}{/block}
</body>
</html>

登录后复制

子模板继承布局：

<!-- application/index/view/user/profile.html -->
{extend name="layout/base" /}

{block name="title"}用户个人资料 - 我的网站{/block}

{block name="css"}
    <link rel="stylesheet" href="/static/css/profile.css">
{/block}

{block name="content"}
    <h2>用户个人资料</h2>
    <p>这里显示用户的详细信息。</p>
    <form>
        <!-- 用户信息表单 -->
    </form>
{/block}

{block name="js"}
    <script src="/static/js/profile.js"></script>
{/block}

登录后复制

当user/profile.html被渲染时，它会先加载layout/base.html作为骨架，然后用自身定义的block内容去替换base.html中同名的block。没有被子模板定义的block会保留基础布局中的默认内容。

在我看来，这两种方式各有侧重，include更偏向于“组件”的概念，而extend则更像是“模板继承”或者“布局框架”。在实际项目中，它们经常会协同使用，比如在一个extend出来的布局文件中，再include一些通用的头部和底部。

ThinkPHP模板包含有哪些实用场景？

ThinkPHP的模板包含功能，无论是include还是extend，都是提升开发效率和项目可维护性的利器。在我多年的开发经验中，它们的应用场景几乎无处不在，尤其是在构建中大型应用时，其优势会非常明显。

首先，最直观的场景就是公共模块的复用。想一下，一个网站几乎每个页面都有头部（导航栏、Logo）、底部（版权信息、备案号）以及侧边栏（广告、热门文章、分类导航）。如果每个页面都复制粘贴这些代码，那简直是噩梦。一旦需要修改Logo或者添加一个导航项，你得改几十上百个文件。使用{include file="public/header" /}和{include file="public/footer" /}，你只需要修改一处，所有页面就都更新了。这对于保持UI的一致性，减少重复劳动，简直是救命稻草。

其次，复杂页面的模块化。一个电商网站的商品详情页可能包含商品图片轮播、商品描述、SKU选择、评价区、推荐商品等多个独立的模块。把这些模块各自做成一个子模板，然后在主模板中按需include进来，不仅让主模板的代码变得清晰易读，也方便团队成员分工协作。比如，前端A负责图片轮播，前端B负责评价区，互不干扰。当某个模块需要调整时，也只需要关注对应的子模板文件，降低了修改的风险。

再来，统一的后台管理系统布局。这是extend标签大显身手的地方。一个后台通常有固定的顶部导航、左侧菜单、右侧内容区。你可以定义一个admin_layout.html作为基准布局，所有的后台页面都extend这个布局。这样，无论你新增多少个管理页面，它们都能自动拥有统一的界面风格和导航结构。当产品经理突然说要调整侧边栏的样式或者添加一个全局通知时，你只需改动布局文件，所有页面就都同步更新了。这种抽象能力，在我看来，是大型项目能够保持整洁和可控的关键。

最后，多语言/多主题支持。虽然不是直接的模板包含功能，但通过合理组织模板结构，结合模板包含，可以更容易实现这些需求。比如，你可以为不同的主题或语言准备一套公共模块的子模板，然后通过配置动态切换加载的模板路径。这让系统具备了更强的灵活性和扩展性。

说白了，模板包含就是帮你把大象装进冰箱，一步步把复杂的页面拆解成可管理、可复用的小块，让开发变得更高效、更愉快。

ThinkPHP模板包含时如何传递变量？

在ThinkPHP的模板包含中，变量的传递机制相对直接且智能，这在我日常开发中感受挺方便的。

默认行为：父模板的变量自动继承

当你在一个主模板中使用{include file="sub_template" /}引入子模板时，主模板中所有可用的变量，默认情况下都会自动传递给子模板，在子模板中可以直接使用。这省去了手动传递的麻烦，非常符合直觉。

举个例子：假设你在控制器中给主模板分配了一个变量$username：

// app/index/controller/Index.php
namespace app\index\controller;

use think\facade\View;

class Index
{
    public function index()
    {
        View::assign('username', '张三');
        View::assign('user_profile', ['age' => 30, 'city' => '北京']);
        return View::fetch();
    }
}

登录后复制

主模板index.html：

<!-- application/index/view/index/index.html -->
<p>欢迎，{$username}！</p>
{include file="public/user_info" /}

登录后复制

子模板user_info.html：

<!-- application/index/view/public/user_info.html -->
<div class="user-card">
    <h3>用户信息</h3>
    <p>用户名：{$username}</p>
    <p>年龄：{$user_profile.age}</p>
    <p>城市：{$user_profile.city}</p>
</div>

登录后复制

渲染后，user_info.html中可以直接访问到$username和$user_profile。这种默认继承行为在大多数情况下都非常实用，避免了重复的变量赋值。

特殊情况：需要传递特定变量或避免变量污染

尽管默认继承很方便，但有时候你可能希望子模板只接收特定的变量，或者为了避免变量名冲突，不希望子模板访问到父模板的所有变量。ThinkPHP的include标签本身没有提供像某些其他模板引擎那样直接在标签内通过with属性传递新变量的机制（比如Blade的@include('view.name', ['some' => 'data'])）。

这意味着，如果你需要给子模板传递一些额外的、特定的变量，而这些变量又不想暴露给整个父模板，或者说这些变量是专门为这个子模板定制的，那么你需要在控制器层面进行更精细的控制，或者在父模板渲染之前，就将这些数据组织好。

一种常见的做法是，将子模板所需的数据封装成一个数组或对象，然后将这个封装好的数据传递给父模板，父模板再将这个封装好的数据传递给子模板。但实际上，由于默认继承，你只需确保这些数据在父模板的上下文中是可用的即可。

如果确实有隔离变量的需求，那可能需要重新审视模板的职责划分，或者考虑在子模板内部进行一些数据的二次处理（但这通常不推荐，模板应尽量保持“傻瓜”状态，只负责展示）。在我的实践中，通常会确保控制器将所有必要的数据都准备好并传递给主模板，然后子模板自然就能获取到所需的数据，很少会遇到需要“隔离”变量的情况。因为一旦某个变量被某个子模块需要，它通常也是整个页面上下文的一部分。

ThinkPHP模板包含有哪些常见的性能考量或优化建议？

关于ThinkPHP模板包含的性能，这其实是一个挺有意思的话题。很多人会担心，如果一个页面include了十几个甚至几十个子模板，会不会导致性能急剧下降？在我看来，这种担忧是合理的，但实际情况往往比我们想象的要好，而且优化点也并非在于减少include的次数。

1. 模板编译机制：一次编译，多次运行

ThinkPHP的模板引擎有一个非常重要的特性：模板编译。当你第一次访问一个包含子模板的页面时，ThinkPHP会将主模板及其所有include或extend的子模板，一起编译成一个PHP文件（通常在runtime/temp目录下）。这个编译后的PHP文件包含了所有模板的最终HTML结构和PHP逻辑。

这意味着什么？后续的访问，只要模板文件本身没有发生修改，系统就会直接执行这个编译好的PHP文件，而不再进行模板解析和文件读取操作。这就大大减少了I/O操作和模板解析的开销。所以，你不用太担心频繁include会造成性能瓶颈，因为大多数开销只发生在第一次访问或模板更新时。

优化建议：

确保缓存目录可写： 编译后的文件需要写入runtime/temp目录，如果这个目录不可写，每次请求都会重新编译，那性能就真的会受影响了。
生产环境关闭调试模式： 调试模式下，ThinkPHP可能会更频繁地检查模板文件是否更新，导致编译操作增加。在生产环境关闭调试模式，能确保编译后的文件被充分利用。

2. 避免模板内执行复杂业务逻辑

虽然模板编译能减轻负担，但如果在子模板内部写入了大量复杂的PHP逻辑（比如数据库查询、复杂的计算），那即便编译了，这些逻辑也会在每次请求时执行。模板的职责应该是“展示”，而不是“计算”或“获取数据”。

优化建议：

数据预处理： 所有需要展示的数据，都应该在控制器中准备好，并通过View::assign()方法传递给模板。模板和子模板只负责接收并展示这些数据。
保持模板“瘦身”： 尽量让模板文件只包含HTML结构和简单的循环、条件判断，避免嵌入复杂的业务逻辑。

3. 合理组织模板文件结构，避免过度碎片化

理论上，把一个页面拆解成成百上千个微小的子模板，虽然每个子模板都很小，但过多的文件I/O（即使是编译时）和文件管理开销，也可能带来一些轻微的负担。当然，这通常不是主要性能问题，更多是管理上的挑战。

优化建议：

平衡拆分粒度： 拆分模板的目的是为了复用和清晰，而不是为了拆分而拆分。一个独立的组件（如导航、评论区）拆分出来是合理的，但如果一个模块只有两三行HTML，且不会在其他地方复用，那可能就没有必要单独抽离成一个子模板。
关注可读性和维护性： 最终的衡量标准还是代码的可读性和维护性。一个结构清晰、易于理解的模板体系，往往也是性能表现不错的。

在我看来，ThinkPHP的模板包含机制在性能方面做得相当不错，大部分情况下，你无需为了性能而刻意减少include的使用。真正的性能瓶颈往往出现在数据库查询、PHP代码逻辑、前端资源加载等其他方面。所以，大胆地利用模板包含来提高开发效率和代码整洁度吧，把优化重点放在数据层和业务逻辑层会更有价值。

以上就是ThinkPHP的模板包含怎么用？ThinkPHP如何引入子模板？的详细内容，更多请关注php中文网其它相关文章！