ThinkPHP函数定义位置在哪_文件位置详细说明

ThinkPHP自定义函数定义位置取决于版本：TP6唯一合法路径是app/common.php，需手动引入app/common/下拆分的函数文件；TP3.x则通过配置或显式引入Common/common.php等路径；模板中调用须用{|}语法且函数不能含$this或框架实例。

ThinkPHP 自定义函数的定义位置不是随便放的，关键看版本。TP6 和 TP3.x 完全不同，放错路径函数就根本不会加载，调用时直接报 Call to undefined function。

TP6 唯一合法路径：app/common.php

这是 TP6 唯一被框架自动加载的全局函数文件，没有之一：

• 必须放在 app/ 目录下（注意是小写 app，不是 App 或 application）
• 文件名必须是 common.php（不是 _common.php、helper.php、functions.php）
• 不能有任何命名空间声明（namespace）、不能 use 类、不能 return/exit/die
• 函数定义后无需加 if (!function_exists()) 包裹——它只加载一次
• 修改后需运行 composer dump-autoload 并清除缓存（如 php think clear:config）

TP6 多文件组织方式：app/common/ 目录

如果函数较多，可拆分为多个文件，但必须满足：

• 目录路径为 app/common/（注意末尾无 .php）
• 子文件如 string.php、date.php，每个文件只写函数定义
• 每个文件内仍不能有 namespace、class、return 语句
• 这些文件不会自动加载，需手动在 app/common.php 中 require_once 引入

TP3.x 的常见路径：Common/common.php 或配置引入

TP3.x 不依赖固定路径，而是靠配置或显式引入：

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

• 传统做法是把函数写在 Application/Common/Common/function.php（大小写敏感）
• 然后在配置中设置 'LOAD_EXT_FILE' => array('function')
• 或者在控制器/模型里用 import('Common.Function'); 手动加载
• 也可通过 include 或 require 直接引入任意路径的函数文件

模板中调用函数的特别限制

无论函数定义在哪，模板里都不能直接写 <?php echo xxx(); ?>：

• 单参数函数：写成 {$time|format_time}
• 多参数函数：用 ### 占位原变量，例如 {$text|truncate=20,###,'…'}
• 函数签名必须严格匹配：参数顺序固定、不能有引用传参（&$var）、必须有返回值
• 函数体内不能使用 $this、app()、db() 等——模板渲染时无上下文