ThinkPHP 3.x display方法详解：从模板渲染到变量输出

一、准备条件：了解模板目录结构

ThinkPHP通过默认的目录规则自动匹配模板文件，理解这一结构是使用 display 方法的基础。

• 默认规则：模板目录/[分组名/][模板主题/]模块名/操作名.后缀
• 默认位置：项目根目录下的 Tpl/ 文件夹。
• 常见配置：
  • TMPL_TEMPLATE_SUFFIX: 定义模板后缀（如 .html 或 .tpl）。
  • TMPL_FILE_DEPR: 设置文件名分隔符（默认为下划线 _），简化深层目录。
  • DEFAULT_THEME: 设置启用的多模板主题名称。

二、真实操作顺序：使用display方法渲染模板

第1步：基本调用（自动识别）

这是最常用的方式，无需传参即可输出当前模块的当前操作对应的模板文件。

$this->display();

第2步：指定模板（跨模块或自定义）

当需要渲染非当前操作的模板，或位于其他模块的模板时，可通过 [主题:]模块:操作 格式指定：

// 调用 Member 模块下的 read 操作模板
$this->display('Member:read');
// 调用 theme 主题下 User 模块的 edit 模板
$this->display('theme:User:edit');

注意：此处 模块 和 操作 仅作为文件名和目录名查找，不要求项目中必须存在对应的逻辑模块或操作方法。

第3步：绝对路径调用

若需绕过系统的目录命名规则，可传入包含相对或绝对路径的文件名。

// 注意：路径通常相对于项目入口文件
$this->display('./Public/menu.html');
// 支持自定义后缀
$this->display('./Config/config.tpl');

第4步：指定输出编码与类型

在渲染时可强制定义输出的字符编码和内容类型（MIME Type），例如生成XML数据：

$this->display('read', 'utf-8', 'text/xml');

第5步：使用show方法直接输出字符串

如果不需要读取文件，而是希望将一段字符串直接当做模板解析并输出，应使用 show 方法：

// 假设 $content 是从数据库取出的HTML片段
$this->show($content, 'utf-8', 'text/html');

第6步：使用fetch方法捕获输出内容

如果需要对渲染后的最终HTML进行二次处理（如加Header信息、统计字数等），请使用 fetch 代替 display。其语法几乎一致，但返回值为字符串而非直接输出。

$html_content = $this->fetch('Member:edit');

三、数据传递：assign方法给模板赋值

要在模板中使用变量，必须在 display 或 show 之前，先使用 assign 方法将数据分配给模板引擎。

// 单个赋值
$this->assign('name', $user['name']);

// 批量赋值（接收关联数组）
$data = array(
    'email' => 'admin@example.com',
    'phone' => '123456'
);
$this->assign($data); 

// 然后执行渲染
$this->display();

安全提示：系统只会输出通过 assign 设定的变量，这有效防止了敏感系统变量的泄露。模板内可使用 {$name} 语法输出生成的值。

四、进阶优化：配置TMPL_PARSE_STRING

为了维护方便，TP3提供了URL相关的路径替换规则。在配置文件（如 Conf/config.php）中修改 TMPL_PARSE_STRING 数组：

'TMPL_PARSE_STRING' => array(
  '__JS__' => '/Public/js/', // 增加新的JS类库替换规则
  '__CSS__' => '/Public/css/',
)

在模板文件中即可直接使用 {__JS__}jquery.js 被转换为 /Public/js/jquery.js。

五、完成判断

确认以上代码运行后，浏览器页面准确显示了通过 display 渲染的HTML内容，且变量正确替换为实际数据。若涉及 show 或复杂配置项修改，需刷新页面验证最终输出源及路径无误。以上就是ThinkPHP 3.x display方法及show方法用法的详细内容，更多关于ThinkPHP PHP框架的资料请关注本站其它相关文章！