ThinkPHP仓库管理系统教程-ThinkPHP-PHP中文网

跑通thinkphp仓库管理系统需绕开三大陷阱：伪静态未配致路由404、database.php配置后因缓存不生效、admin模块未注册及中间件缺失导致登录后跳空白页。

thinkphp仓库管理系统教程

直接跑通 ThinkPHP 仓库管理系统，关键不是“学完框架”，而是绕开三个默认陷阱：伪静态没配好导致路由 404、database.php 配置后不生效、以及登录成功却跳转到空白 /admin/index 页面——那是因为你还没建 admin 模块或没配中间件拦截。

伪静态规则必须匹配 public 目录入口

ThinkPHP 6+ 强制要求 Web 服务器根目录指向 /public，但很多人仍把整个项目丢进 Apache 的 htdocs 或 Nginx 的 root 下。结果是 index.php 找不到，所有 URL 都 404。

Apache 用户：确保 .htaccess 在 /public 目录下，内容为：

RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]

Nginx 用户：在 server 块中把 root 明确设为 /path/to/your/project/public，不要用 alias；然后删掉 location 块里所有重写逻辑，ThinkPHP 自带的 public/index.php 已能正确解析 PATH_INFO
验证方式：访问 http://localhost/index.php?s=/admin/login，如果出现登录页，说明入口通了；再试 http://localhost/admin/login，能打开才代表伪静态生效

database.php 修改后要清空 runtime/cache

ThinkPHP 会缓存配置，改完 config/database.php 不清缓存，等于没改。常见现象是连错库、报 SQLSTATE[HY000] [1045] Access denied 却确认账号密码没错。

ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

缓存路径固定在 runtime/cache/ 和 runtime/config/，直接 rm -rf runtime/cache/* runtime/config/*
别只改 app/database.php（那是 TP5.1 旧路径），TP6+ 配置统一在 config/database.php
如果用 MySQL 8+，注意 'hostname' => '127.0.0.1' 不能写成 'localhost'，否则可能因 socket 连接失败；同时确认用户权限已授权给 %'@'%'% 而非仅 'root'@'localhost'

admin 模块必须手动注册路由且启用中间件

ThinkPHP 默认只有 index 模块，/admin/login 这类地址不会自动识别——它不是“子目录”，而是独立模块路由。没注册就访问，会进 IndexController 或直接抛出 Module not exists:admin 错误。

在 route/app.php 中显式定义 admin 路由：

use think\facade\Route;
Route::domain('admin', function () {
    Route::rule('login', 'admin/login/index');
    Route::rule('index', 'admin/index/index')->middleware('checkLogin');
});

checkLogin 中间件必须存在，且在 app/middleware.php 中注册；它不能只靠 session 判断，要检查 session('admin_user') 是否存在并有效，否则登录后跳转 /admin/index 时被放行到空页面
控制器命名空间必须严格为 app\admin\controller\Login，类名首字母大写，方法名小写；模板路径对应为 view/admin/login/index.html，少一级目录就 404