COMMON_PATH是ThinkPHP框架定义的常量，指向公共模块目录（默认APP_PATH.'Common/'），在框架初始化后全局可用；__DIR__绑定当前文件路径，无法跨文件保持一致，且受符号链接、工作目录、平台分隔符等影响，故不可替代COMMON_PATH。
COMMON_PATH 是什么，为什么不能直接用 __DIR__ 替代
COMMON_PATH 是 ThinkPHP 框架定义的常量，指向公共模块目录，默认值是 APP_PATH . 'Common/'，即应用目录下的 Common/ 子目录。它不是 PHP 原生常量，而是框架在初始化时通过 define() 注册的，作用范围覆盖整个应用生命周期（包括命令行和 HTTP 请求）。
常见错误是：在某个控制器里写 require_once __DIR__ . '/../Common/Helper.php'，以为能等效替代 COMMON_PATH —— 这会失败，因为 __DIR__ 绑定的是当前文件位置（比如 /app/controller/Index.php），而 COMMON_PATH 是统一由入口文件推导出的逻辑路径，不受当前文件嵌套层级影响。
- 跨模块调用时，
__DIR__无法保证一致性；COMMON_PATH始终指向同一物理位置 -
COMMON_PATH可被重定义（如部署时改到项目根级），__DIR__完全不可控 - 命令行执行时，工作目录可能远离项目结构，
__DIR__拼接相对路径极易断裂
COMMON_PATH 在哪里定义、何时可用
ThinkPHP 在框架启动早期（通常是入口文件 index.php 或 thinkphp/start.php）完成 COMMON_PATH 的定义。它依赖 APP_PATH，而 APP_PATH 默认由入口文件所在目录决定。
这意味着：只要没执行到框架初始化逻辑之前，COMMON_PATH 就未定义，直接使用会触发 Notice: Use of undefined constant COMMON_PATH 错误。
立即学习“PHP免费学习笔记（深入）”；
- 在入口文件顶部、
require框架前，不能用COMMON_PATH - 在
common.php配置文件里也不能用 —— 它本身就在COMMON_PATH下，此时常量尚未注册 - 真正安全可用的时机：控制器、模型、中间件、命令类等框架已加载完毕的上下文中
COMMON_PATH 和 __DIR__ 混用时的典型翻车点
有人试图“保险起见”，写成 defined('COMMON_PATH') ? COMMON_PATH : __DIR__ . '/../../Common/'，结果反而更危险。
问题在于：__DIR__ . '/../../Common/' 在不同文件中计算结果完全不同。比如在 /app/command/Import.php 里执行，上两级是 /app/；但在 /app/library/Utils.php 里执行，上两级可能是 /app/library/ → /app/ → /，直接越界。
- 符号链接环境下，
__DIR__不解析，COMMON_PATH经过realpath()处理（框架内部默认做） - Windows 路径分隔符混用：
__DIR__返回反斜杠，拼接'/../Common/'可能产生C:\app\controller\..\..\Common\，部分函数（如is_dir()）在旧版本 PHP 中识别不稳定 - 容器或 phar 环境下，
__DIR__返回伪协议路径（如phar://app.phar/app/），而COMMON_PATH总是真实文件系统路径
想动态获取公共模块路径？别绕开框架机制
如果你在非标准位置（比如自定义命令、独立脚本）需要访问 Common/ 目录，正确做法不是猜路径，而是复用框架已有的推导逻辑：
最简方式是手动模拟框架定义过程：
if (!defined('APP_PATH')) {
define('APP_PATH', dirname(__DIR__) . '/');
}
if (!defined('COMMON_PATH')) {
define('COMMON_PATH', APP_PATH . 'Common/');
}
但注意：这仅适用于你清楚 APP_PATH 位置的场景。更健壮的做法是读取框架配置或使用 think\facade\App::getAppPath()（TP6+），前提是已初始化 App 类。
真正容易被忽略的一点：ThinkPHP 的 COMMON_PATH 默认不包含 Common/Conf/ 或 Common/Lang/ 下的子目录 —— 它只是个基础路径前缀。具体子资源仍需拼接，比如配置文件是 COMMON_PATH . 'Conf/config.php'，而非 COMMON_PATH . 'config.php'。
