thinkphp 6/8 的 app/ 目录中，controller、model、view、middleware、event 及模块目录（如 admin、api）必须全小写；大小写错误或复数形式（如 controllers）将导致 psr-4 自动加载失败。
app/目录下哪些子目录名必须小写
ThinkPHP 6/8 的 app/ 目录里，controller、model、view、middleware、event 这些子目录名必须全小写，且不能带任何大写字母或下划线。框架的自动加载器（PSR-4）硬编码识别这些路径，比如它只认 app/controller/UserController.php，不认 app/Controller/UserController.php 或 app/controllers/UserController.php。
模块目录（如 admin、api）也必须全小写——多应用模式下，框架内部会把模块名强制转为小写做标识，你建了 app/Admin，实际注册的是 admin 模块，但类文件路径仍按命名空间拼成 app/Admin/controller/Index.php，结果就是找不到类。
- 正确：
app/admin/controller/LoginController.php（模块目录小写 + controller 小写） - 错误：
app/Admin/Controller/LoginController.php（大小写混用，Linux 下直接报Class not found） - 错误：
app/admin/controllers/LoginController.php（复数形式，Loader 不识别）
config/目录为什么不能放子目录
config/ 目录只自动加载其一级 PHP 文件，不会递归扫描子目录。你放一个 config/database/mysql.php，框架根本不会读它，也不会合并进 database 配置分组——Config::get('database.mysql.host') 必然返回 null。
业务配置必须平铺在 config/ 根目录：比如微信配置写成 config/wechat.php，支付宝写成 config/alipay.php，每个文件返回一个数组，框架自动合并进对应键名。
- 敏感配置（数据库密码、API密钥）必须写在
.env，PHP 配置文件里只调用env('DB_PASSWORD') - 改了
.env后不生效？删掉runtime/config/缓存再试 - 自定义配置文件（如
config/custom.php）需手动执行Config::load('custom')，不能依赖自动加载
public/为什么必须是 Web 根目录
public/ 是唯一合法的 Web 入口目录，Nginx/Apache 必须将其设为网站根目录。设错会导致三类严重问题：
- 源码泄露：
config/database.php被浏览器直接下载，数据库密码裸奔 - 逻辑暴露：
app/controller/UserController.php可被直连，返回原始 PHP 代码或 500 错误 - 静态资源 404：
public/static/css/app.css的 URL 是/static/css/app.css，根目录设错就找不到
本地开发用 PHP 内置服务器时，必须加 -t public/ 参数：php -S localhost:8000 -t public/ router.php；public/index.php 是唯一入口，删不得、挪不得、重命名不得。
插件目录为什么不能放在 app/ 里面
插件不是“另一个模块”，它是独立可启停的扩展单元，必须放在与 app/ 并列的 addons/ 目录下（官方约定路径），比如 addons/wechat_login/。一旦塞进 app/，路由扫描、自动加载、命令行工具（php think）全部错乱——框架根本不认为那是插件。
每个插件目录下必须有 addon.php，且其中 name 和目录名必须完全一致（区分大小写），path 必须用双反斜杠并以反斜杠结尾，例如：'path' => 'addons\wechat_login\'。写成斜杠 / 或漏掉末尾反斜杠，类加载器就找不到 WechatLoginService。
插件内的控制器不会被自动扫描，必须在 route.php 中显式绑定路由，否则访问 /wechat_login/login 就是 404。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
