ThinkPHP5域名绑定模块大小写报错处理-ThinkPHP-PHP中文网

thinkphp5在linux下usercenter模块404是因为框架未对模块名做strtolower()转换，而linux文件系统区分大小写；需手动修改app.php中$module赋值处添加strtolower()，并清理runtime缓存，同时统一规范模块目录名为小写。

thinkphp5域名绑定模块大小写报错处理

ThinkPHP5 在 Windows 开发时能正常访问 userCenter 模块，一上 Linux 就 404，不是路由没配，是模块名大小写被框架“吃掉”了——TP5 默认只对控制器和操作名做 strtolower() 转换，模块名不参与自动归一化。

为什么 `userCenter` 在 Linux 下直接失效

Linux 文件系统严格区分大小写，application/userCenter/ 和 application/usercenter/ 是两个目录。但 TP5 的模块解析逻辑在 think\App.php 第 336 行附近，只对 $controller 和 $action 做了 strtolower()，而 $module 没走这步，导致 URL 中的 userCenter 被原样传入，最终去匹配不存在的 application/userCenter/ 目录（实际你可能建的是 usercenter 或 UserCenter）。

检查 application/ 下真实目录名：用 ls -l application/ 看清大小写，别信 Windows 资源管理器显示
确认 URL 访问路径是否带斜杠：/userCenter/ 和 /userCenter 在某些 Nginx 配置下会被重写，干扰模块识别
错误提示里若出现 Module not exists: userCenter，说明框架已拿到该字符串，但没找到对应目录

手动补全模块名大小写转换逻辑

打开 thinkphp/library/think/App.php，定位到模块解析处（TP5.1 多在第 336 行左右），找到类似这行：

PHP

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

下载

$module = strip_tags($result[0] ?: $config['default_module']);

把它改成：

$module = strip_tags(strtolower($result[0] ?: $config['default_module']));

不要加额外判断或配置开关，TP5.1 没有内置 $convert 变量，硬加会导致未定义变量警告
改完立刻删掉 runtime/cache/ 和 runtime/common/ 下所有文件，否则旧缓存会掩盖修改效果
如果用了多应用模式（如 app/admin/），此修改同样生效，模块名统一转小写后才能匹配到 app/admin/ 目录

更安全的长期方案：统一模块命名规范

硬改框架源码容易在升级时丢失，推荐从项目源头约束：

所有模块目录名强制小写：usercenter、admin、api，禁止驼峰或首字母大写
路由定义中显式指定模块，避免依赖 URL 自动解析：Route::get('uc/index', 'usercenter/index/index');
CI/CD 流程中加入校验脚本，用 find application -maxdepth 1 -type d | grep "[A-Z]" 扫描非法大写字母目录
模板中引用模块资源时，也统一用小写路径：{include file="usercenter@public/header"}，避免大小写混用引发二次问题

真正麻烦的不是改一行 strtolower()，而是团队里有人在 Windows 上新建了 UserCenter 目录，Git 提交时大小写不敏感，推到 Linux 服务器就只剩空壳——所以修复动作必须同步代码规范、CI 检查和成员意识。