多应用模式下应共用同一入口文件public/index.php，通过域名或路由区分应用，禁用自动多入口检测（define('app_multi', false)），配置app/multi.php实现域名绑定，清空runtime缓存确保生效。
多应用模式下入口文件怎么放才不冲突
ThinkPHP 的多应用模式默认要求每个应用有独立入口文件，但实际部署时往往希望共用一个入口（比如 public/index.php），否则 Nginx 配置、CDN 缓存、HTTPS 证书管理都会变复杂。
正确做法是：所有应用统一走同一个入口文件，靠路由或域名区分应用，而不是靠多个 index.php。ThinkPHP 6+ 默认支持这种模式，但需要显式关闭「自动多入口检测」，否则会报 App not exists 错误。
- 在
public/index.php开头添加define('APP_MULTI', false);，禁用框架自动识别多入口的逻辑 - 确保
config/app.php中'app_multi' => true已开启多应用支持 - 不要把不同应用的入口文件丢进
public/下（如admin.php、api.php），那是旧版单入口伪多应用的写法，和当前多应用目录结构不兼容
域名绑定应用时 config/app.php 的 app_name 怎么设
ThinkPHP 多应用模式下，app_name 不是写死在配置里的，而是由入口请求动态解析出来的——它取决于 URL 路径或 HTTP Host。硬编码 'app_name' => 'admin' 会导致所有请求都进 admin 应用，其他应用完全不可达。
真正起作用的是 app/multi.php（或 config/multi.php）里的域名映射规则。这个文件必须存在且返回数组，格式为 ['域名' => '应用名']。
- 例如绑定
admin.example.com到admin应用：返回['admin.example.com' => 'admin'] - 支持通配符：
['*.api.example.com' => 'api']，但注意 PHP 版本需 ≥ 7.4 且启用fnmatch - 如果没配
multi.php，框架会 fallback 到路径解析（如/admin/xxx），此时域名绑定失效 - 修改后务必清空
runtime/app.php缓存，否则新规则不生效
public 目录下子目录结构和 app 目录的关系
多应用模式下，app 目录里的子目录（如 app/admin、app/api）就是应用目录，它们和 public 下的任何子目录没有映射关系。有人误以为要在 public/admin/ 放入口，这是典型误区。
public 目录只负责静态资源和统一入口，所有应用共享同一套 public/static/ 和 public/index.php。应用专属资源（如 admin 的 JS/CSS）应放在 public/static/admin/，由应用内模板自行引用。
- 禁止在
public/下创建与应用同名的子目录（如public/admin/），否则 Nginx 可能直接返回 403 或 404，绕过框架路由 - 应用的视图模板仍放在
app/{name}/view/，不是public/{name}/view/ - 如果用了多语言或主题切换，
public/static/下可按应用分层，但路径拼接必须由 PHP 控制，不能依赖 Web 服务器自动匹配
调试时常见的 APP\_NAME 不生效问题
最常遇到的现象是：明明绑定了域名，但始终进入默认应用（index），或者日志里反复出现 App not exists: xxx。根本原因往往是 APP_NAME 没被正确设置或覆盖。
ThinkPHP 在生命周期早期就确定 APP_NAME 常量，一旦定下就不会再改。它优先取自 $_SERVER['HTTP_HOST'] 查 multi.php，失败则 fallback 到 PATH_INFO 第一段，最后才是 index。
- 检查
multi.php是否被正确加载：在public/index.php开头加var_dump(config('multi'));看输出是否为空 - 确认 Web 服务器未过滤
Host头（某些云 WAF 或反向代理会重写 Host，导致匹配失败） - CLI 请求无法触发域名绑定，
php think route:list这类命令默认走index应用，要指定加--app=api - 开发环境用
localhost测试时，必须在multi.php显式写'localhost' => 'admin'，不能依赖通配符
域名绑定不是黑盒魔法，它依赖一次准确的 Host 匹配和干净的缓存状态。只要 multi.php 存在、内容有效、缓存清空、Host 头可达，就一定走得到对应应用目录。其余所有“不生效”，基本都是这四点中某一个漏了。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
