thinkphp中application/common.php是应用层公共函数文件，仅在应用初始化后加载，必须位于application目录下且以return数组或定义函数方式编写；关键配置应写入根目录config.php而非application/config.php，以确保命令行与http请求均生效。
如果您在ThinkPHP项目中需要统一管理应用级的公共函数或全局配置，但发现common.php未被正确加载或功能异常，则可能是由于文件位置、命名或加载机制不符合框架规范。以下是符合ThinkPHP官方规范的应用公共文件配置方法：
一、确认common.php的正确位置与作用范围
ThinkPHP中，application/common.php 是应用层公共函数文件，仅在应用初始化后加载，适用于控制器、模型等应用代码中调用的辅助函数；它不会在命令行环境或框架启动早期（如配置合并阶段）生效。该文件必须位于 application 目录下，且不能置于子模块目录内。
1、检查项目结构中是否存在 application/common.php 文件路径。
2、确认该文件以 return 语句返回一个关联数组，或直接定义函数（无 return 亦可，但需确保语法合法）。
3、避免将该文件误放至 app/ 或根目录下，否则框架不会自动识别并加载。
二、确保config.php作为顶层配置入口同步覆盖依赖项
应用公共配置（如数据库、缓存、日志等核心运行参数）必须写入根目录下的 config.php，而非仅放在 application/config.php 中。因为 config.php 是 think\App::initCommonConfig() 优先合并的顶层配置入口，影响所有模块、命令行及HTTP请求；而 application/config.php 属于应用级配置，仅在应用初始化后加载，易导致 Db::connect() 等操作在命令行中报错。
1、打开项目根目录，确认存在 config.php 文件（非 application/config.php）。
2、将数据库连接、缓存驱动、日志级别等关键配置项迁移至此文件中。
3、删除 application/config.php 中重复定义的同名配置，防止优先级冲突。
三、启用多应用模式时区分公共文件加载层级
在多应用模式下（如 admin、api、home），每个应用拥有独立的 common.php，但这些文件互不共享。若需跨应用复用函数，应将通用函数提取至 extend/ 目录下的自定义类库 或通过 Composer 自动加载机制引入，而非依赖 application/common.php 的全局可见性。
1、在 extend/ 目录下新建 helpers/ 目录，并创建 functions.php。
2、在 composer.json 的 autoload.files 中添加该文件路径。
3、执行 composer dump-autoload 命令使新函数文件生效。
四、验证公共文件是否被实际加载
可通过框架内置的调试方式验证 common.php 是否触发执行：在 application/common.php 开头插入 die('common.php loaded');，然后访问任意HTTP接口或运行 php think hello 命令。若页面输出该字符串，说明文件已加载；若无反应，则证明未进入应用初始化流程，需检查入口文件或应用模式配置。
1、编辑 application/common.php，在首行加入 die('common.php loaded');
2、通过浏览器访问网站首页，观察是否输出提示信息。
3、在命令行执行 php think hello，观察终端是否中断并显示该字符串。
五、禁用自动加载common.php并改用显式引入
当项目存在兼容性问题或需精确控制加载时机时，可关闭框架对 common.php 的自动加载行为，改为在 Base Controller 或 App Service Provider 中手动 require_once。此方式绕过框架默认机制，适用于高度定制化场景。
1、在 application/config.php 中设置 'auto_load_common' => false（需框架支持该配置项，否则忽略）。
2、在 app\BaseController.php 的构造函数中添加 require_once APP_PATH . 'common.php';。
3、确保该 BaseController 被所有控制器继承，以保障函数可用性。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
