TP6升8自定义应用命名空间定义法-ThinkPHP-PHP中文网

tp8已彻底移除多应用模式，必须删除app/multi.php、设'app_multi'=>true、用app::factory()、子应用目录需含controller/和route/app.php且命名空间严格匹配目录结构。

tp6升8自定义应用命名空间定义法

TP6 升级到 TP8 后，自定义应用命名空间不能沿用 TP6 的 multi-app 扩展写法，必须改用 TP8 原生的多应用目录结构 + app_multi 配置双驱动，否则应用识别失败、路由 404、类自动加载静默跳过。

TP8 彻底移除了 topthink/think-multi-app 扩展的兼容支持。即使你保留了 composer require topthink/think-multi-app，它也不会生效——TP8 的 PSR-4 自动加载器只认实际目录路径。

子应用必须放在 app/ 下同级目录，例如 app/admin、app/api，不能是 app/admin/controller 这种嵌套在单应用目录里的伪结构
每个子应用的根命名空间必须与目录名严格一致：app/admin → namespace app\admin;；app/api → namespace app\api;
控制器类文件名必须与类名完全一致（大小写敏感）：app/admin/controller/Index.php 内必须是 class Index，不能是 class index 或 class IndexController
入口路由文件必须命名为 route/app.php（不是 route.php），且只对当前子应用生效

TP6 的 app/multi.php 在 TP8 中已完全废弃。如果该文件还存在，TP8 会误判为单应用模式，导致所有子应用路由无法匹配，请求全部落入默认应用（通常是 app/index）。

Meshy

Meshy是一款AI 3D生成工具，AI 快速从文本或图像生成 3D 模型。

下载

删除 app/multi.php（哪怕它是空文件）
在 config/app.php 中设置：'app_multi' => true
确认 APP_NAMESPACE 环境变量未被覆盖（如 .env 中不要写 APP_NAMESPACE=app，TP8 会自动推导）
检查 public/index.php 入口是否仍调用 App::create() 而非 App::factory() —— TP8 多应用必须用 App::factory()

TP8 不再支持短命名空间别名，所有框架类引用必须走完整命名空间，且控制器基类也变了。

控制器必须以 namespace app\admin\controller; 开头，继承 think\controller\Base（不是 think\Controller）
模型必须以 namespace app\admin\model; 开头，继承 think\Model（不是 think\Model as BaseModel）
use think\facade\Db 仍可用，但 use think\Model 必须删掉或改为 use think\Model as Model;，否则类名冲突
中间件类必须实现 think\contract\MiddlewareInterface，且 handle() 方法必须声明返回类型：public function handle(Request $request, \Closure $next): Response

这不是路由没写对，而是 TP8 根本没识别出 admin 是一个应用。本质是命名空间链断裂。

检查 app/admin/controller/Index.php 第一行是否为 namespace app\admin\controller;（注意结尾分号）
运行 php think route:list，看输出里有没有 admin 前缀的路由 —— 没有就说明应用未加载
Linux 下用 ls -l app/admin/controller/ 确认文件名是 Index.php，不是 index.php 或 IndexController.php
别在 app/admin/route.php 里写 Route::get('index', 'index/index')，必须用完整类名：Route::get('index', [\app\admin\controller\Index::class, 'index'])