ThinkPHP自定义命名空间核心是路径与命名空间严格对应并自动加载：入口定义APP_NAMESPACE（如myapp）适配主应用；TP5用root_namespace注册额外根命名空间；TP8子应用需显式配置namespace并路由指向；extend目录下目录名与一级命名空间同名即自动注册。

ThinkPHP 文件自定义命名空间，核心是让类文件路径与声明的命名空间严格对应，并通过框架机制完成自动加载。不同版本策略略有差异，但逻辑一致：目录结构决定命名空间层级，框架配置决定映射关系。

入口常量定义（TP5/TP6 通用）

这是最直接、兼容性最好的方式，适用于修改主应用命名空间前缀（如把默认 app 改成 myapp）：

• 在入口文件（如 public/index.php）中，define('APP_PATH', ...) 之后、require .../start.php 之前，添加：
  define('APP_NAMESPACE', 'myapp');
• 此时 application 目录下的控制器需放在 application/myapp/controller/，并声明命名空间：
  namespace myapp\controller;
• 模型、验证器等同理，路径和命名空间都要同步调整为 myapp\model、myapp\validate 等

配置 root_namespace（TP5 专用）

适合注册额外的根命名空间（非 app），比如引入独立业务包或第三方封装库：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

• 在 application/config.php 中添加或修改：
  'root_namespace' => ['mylib' => APP_PATH . '../mylib/']
• 把类文件放在 mylib/Service/UserService.php，命名空间写为：
  namespace mylib\Service;
• 使用时可直接 new \mylib\Service\UserService()，无需额外引入

多应用模式下的子应用命名空间（TP8 必须显式注册）

TP8 的 app/admin、app/api 等子目录默认不被识别为独立应用，必须手动激活命名空间：

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

• 确认 config/app.php 中已开启：'app_multi' => true
• 确保子目录下存在 app/admin/config/app.php，且内容包含：
  'namespace' => 'app\admin'
• 控制器路径为 app/admin/controller/Index.php，命名空间必须是：
  namespace app\admin\controller;
• 路由需显式指向完整命名空间：Route::get('admin/index', 'app\admin\controller\Index@index')

扩展目录自动注册（所有版本都支持）

将自定义类库放入 extend/ 目录，框架会自动注册同名根命名空间：

• 创建 extend/mytool/Helper.php，命名空间写：
  namespace mytool;
• 类内定义 class Helper { ... }
• 即可 anywhere 使用：$h = new \mytool\Helper();
• 注意：目录名 mytool 必须与命名空间一级完全一致，大小写敏感