ThinkPHP函数调用依赖约定与自动加载：控制器中直接使用单字母函数（如I、C、M等），模板中须用{:}语法调用内置或已注册的自定义函数，自定义函数需置于app/common.php或extend/目录并配置autoload。
ThinkPHP 的函数调用不靠“new”也不靠“use”，而是靠约定+自动加载，核心就两点：框架内置的单字母函数（如 C、I、M）直接用；自定义函数写在固定位置（如 app/common.php）就能全局调用。新手卡住，往往是因为没分清“模板里怎么用”和“控制器里怎么用”，下面按使用场景说清楚。
控制器里常用单字母函数怎么用
这些函数在控制器方法中直接写，不用引入、不用实例化：
-
I()：安全取参数——
I('get.id', 0)获取 GET 中的 id，默认为 0；I('post.title', '', 'htmlspecialchars')自动过滤 XSS -
C()：读写配置——
C('database.hostname')读配置；C('app_debug', true)临时开启调试 -
M()：快速查数据库——
M('User')->where('status=1')->select()，不用建模型文件也能操作 -
D()：调用完整模型——
D('User')->login($data)，前提是app/model/User.php存在且含业务逻辑 -
U()：生成 URL——
U('Index/detail', ['id' => 5])输出 /index/detail/id/5（依路由规则变化）
模板里不能直接写 PHP 函数，得用内置语法
模板（.html 文件）不是 PHP 脚本，<?php echo date(); ?> 会报错。必须用 ThinkPHP 模板引擎认可的方式：
- 用内置函数：{:date('Y-m-d H:i', $create_time)} —— 注意
$create_time必须是整型时间戳 - 用管道符过滤：{$name|default='匿名'|htmlspecialchars} —— 链式处理，轻量又清晰
- 调助手函数：{:think('session', 'user.name')} 等价于 PHP 中的
session('user.name') - 自定义函数要先注册：把
function my_cut($str) { return mb_substr($str, 0, 10); }写进 app/common.php，模板里才能用 {:think('my_cut', $title)}
助手函数在哪写？怎么让它自动生效
ThinkPHP 会自动加载 app/common.php 和 extend/ 目录下的函数文件，无需手动 require：
立即学习“PHP免费学习笔记（深入）”；
- 项目级通用函数（如格式化价格、生成订单号）→ 放
app/common.php - 团队共享或可复用的工具函数 → 放
extend/utils.php，并在composer.json的"autoload": {"files": ["extend/utils.php"]}中声明 - 命名避开 PHP 关键字和 ThinkPHP 原生函数名（比如别叫
dump或config），推荐加前缀如my_log()、fmt_money()
调试和排查常见报错
函数调用失败，90% 是路径、命名或上下文问题：
- “Call to undefined function xxx” → 检查函数是否真在
app/common.php里，且文件已保存、服务已重启（CLI 下改完 common.php 有时需 reload php-fpm） - 模板里 {:xxx()} 什么也不输出 → 先确认
$xxx变量已通过$this->assign('xxx', $value)传入；再看函数是否返回值（空字符串或 null 也会不显示） - “Undefined index” 类警告 → 用
I('post.field', '')代替直接取 $_POST['field']，避免未提交时报错 - 时间函数出错 → 内置
date函数只认时间戳，别传 '2026-07-07' 这样的字符串，先用strtotime()转换（在控制器里转好再传给模板）
