ThinkPHP中不能直接require_once DIR . '/common.php'，因为__DIR__随执行环境变化导致路径不可预测，易报错；应统一锚定稳定路径，推荐方式一：放app/common.php由框架自动加载。

ThinkPHP 里为什么不能直接 require_once __DIR__ . '/common.php'

因为 ThinkPHP 的自动加载机制和运行时环境（如 CLI、Web、多模块）会让 __DIR__ 指向不可预测的位置——比如在命令行执行时是入口文件目录，在控制器里调用时可能是控制器所在目录。硬写 __DIR__ 绝对路径，换一个入口或部署方式就报 failed to open stream。

应该用 vendor/topthink/framework/src/think/Helper.php 提供的 import() 吗？

不推荐。这个 import() 是早期 TP3 的遗留函数，TP5/6 已移除，官方也不维护。强行找兼容版容易引入命名冲突或加载顺序问题。更关键的是：它不走 Composer 自动加载，无法被 IDE 识别、无法被静态分析工具追踪。

正确加载自定义函数文件的三种方式

核心原则：让路径解析脱离当前文件位置，统一锚定到已知稳定位置。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 方式一（推荐）：放在 app/common.php，框架启动时自动加载（TP6.1+ 默认启用，检查 config/app.php 中 'core_file' => ['common'] 是否存在）
• 方式二：用 think\facade\App::getAppPath() 构造路径：

  require_once \think\facade\App::getAppPath() . 'common/functions.php';

  注意：必须确保该文件在 app/ 下，且不能在配置文件中提前调用（会触发循环依赖）
• 方式三：通过 Composer 的 autoload.files 注册（适合全局工具函数）：

  "autoload": { "files": ["app/common/functions.php"] }

  改完后别忘了运行 composer dump-autoload

常见错误：在中间件或事件回调里用 require_once 动态加载

这会导致重复加载（中间件可能被多次执行）、函数重定义报错（Cannot redeclare xxx()），也破坏了 PSR-4 自动加载约定。如果真需要条件加载，用 function_exists() 做兜底：

if (!function_exists('my_helper')) { require_once \think\facade\App::getAppPath() . 'common/my_helper.php'; }

但更好的做法是把逻辑封装进服务类，由容器管理实例生命周期。

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

真正麻烦的不是“怎么加载”，而是加载时机和作用域——函数一旦声明就全局可见，混用不同版本的 common.php 很容易导致静默覆盖。所以路径要稳，加载要早，校验要勤。