ThinkPHP8非驼峰操作模板定位法-ThinkPHP-PHP中文网

thinkphp 8 中模板路径不按驼峰转小写下划线时，需手动指定：用 $this->fetch('api/index') 或 view('admin_v2/dashboard') 绕过自动推导；跨模块或非标准路径须用绝对路径如 /common/header；{include} 起点为当前模板目录，统一加前置斜杠。

thinkphp8非驼峰操作模板定位法

模板路径不按驼峰转小写下划线，怎么手动指定

ThinkPHP 8 默认把 UserController → user_controller → 再转成 user 目录名，但如果你的控制器类名是 APIController 或 AdminV2Controller，自动推导会失败，直接报 Template not found。这时候不能靠“改类名”，得在控制器里显式告诉框架模板在哪。

$this->fetch('api/index')：跳过自动推导，直接按字符串路径找 app/view/api/index.html
return view('admin_v2/dashboard', ['data' => $data])：用门面调用，同样绕过类名解析逻辑
若控制器继承自 think\Controller，还可重写 getTemplatePath() 方法，返回自定义路径前缀（如 return './view/custom/';）

跨模块或非标准目录结构下 fetch() 怎么写才不崩

默认 $this->fetch('index') 是相对当前控制器所在模块的 view/ 子目录，但如果你的模板放在 app/view/common/ 或 app/view/shared/ 这类非模块平级路径下，必须用绝对路径写法。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

写法一：$this->fetch('/common/header')（开头带 / 表示从 view/ 根开始）
写法二：$this->fetch('index@common/header')（@ 前是模块名，仅当 common 是合法模块时有效）
写法三：用门面 + 绝对路径：View::fetch('/shared/footer', ['copyright' => date('Y')])
注意：$this->fetch('./footer') 或 $this->fetch('../common/header') 全部无效 —— ThinkPHP 不解析 . 和 ..

为什么 {include} 里的路径和 fetch() 不统一

这是最容易混淆的点：$this->fetch() 的路径起点是 view/ 根目录，而 {include file="xxx"} 的起点是「当前模板所在目录」。比如你在 app/view/user/profile.html 里写 {include file="header"}，它会去找 app/view/user/header.html，不是 app/view/header.html。

统一做法：所有 {include} 都加前置斜杠，如 {include file="/common/header" /}
传参时别写 PHP 数组：{include file="/common/nav" menu_items="[{'name':'首页'}]"} 会直接报错或静默忽略
正确传参：{include file="/common/nav" menu_items=$menu_list}，且确保 $menu_list 已在控制器中用 assign() 或 fetch() 第二个参数传入
嵌套包含时，子模板里再用 {include}，路径依然以它自己所在目录为起点，不是父模板的目录