必须开启app_multi_module配置，thinkphp5默认单模块，未设true时即使建admin目录也会报“模块不存在”；该配置控制url模块名解析，是多模块运行前提。
多模块开发必须开启 app_multi_module 配置
ThinkPHP5 默认是单模块（index）启动，不显式开启多模块支持时，即使你手动建了 admin 目录，访问 /admin/index/index 也会报错「模块不存在」。关键就在 application/config.php 中这一行：
'app_multi_module' => true,
漏掉这句，后续所有操作都白搭。它控制框架是否解析 URL 中的模块名，不是可选开关，而是多模块运行的前提。
常见错误现象：
- 访问
/admin返回 404 或「Module not exists:admin」 - 入口文件里写了
define('BIND_MODULE', 'admin/index')，但实际请求仍走index模块
模块目录命名和路径必须全小写、无空格、避开 PHP 保留字
TP5 对模块名校验严格：只接受小写字母 + 下划线，且不能是 class、function、return 等保留字（参考 PHP 官方保留关键字列表）。例如以下命名会导致自动加载失败或路由解析中断：
-
Admin（首字母大写 → 命名空间解析失败） -
api-v1（含短横线 → 类自动加载器无法识别） -
list（PHP 保留字 →app\list\controller\Index会语法报错）
正确做法是统一用 admin、api、user_center 这类纯小写+下划线组合，并确保在 application/ 下存在对应目录：
application/ ├── index/ ├── admin/ ← 必须存在，且名字与 URL 模块段完全一致 └── config.php
URL 访问路径默认带模块名，绑定后可隐藏
开启 app_multi_module => true 后，URL 必须显式携带模块标识，比如：
-
/index/index/hello→ 走index模块 -
/admin/index/index→ 走admin模块
若想让后台访问更简洁（如直接 /admin），有两种方式：
① 全局绑定（适合单一后台入口）：在 public/admin.php 入口文件中加：
define('BIND_MODULE', 'admin/index');
② 路由绑定（推荐）：在 route/route.php 中写：
Route::rule('admin', 'admin/index/index', 'GET|POST');
注意：绑定后仍需保证 admin 模块目录存在，且控制器类命名空间为 app\admin\controller\Index；否则会提示「Class not found」。
入口文件和 .htaccess 配合决定能否去掉 index.php
即使配置了多模块，如果服务器没正确重写 URL，访问 /admin/index/index 仍可能跳转到 /index.php/admin/index/index 或直接 404。关键点有两个：
- Nginx/Apache 必须把网站根目录指向
public/（不是项目根目录） -
public/.htaccess中的 RewriteRule 必须用index.php?/$1（带问号）而非index.php/$1
Apache 下典型有效规则：
<ifmodule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L]
</ifmodule>
少一个 ?，$_SERVER['PATH_INFO'] 就拿不到，TP5 的 URL 解析链就断了——这是最常被忽略的底层细节。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
