01 / REQUIREMENTS
环境要求，先对齐。
确保本地环境满足以下条件，安装才能顺利进行。
| 组件 | 版本要求 | 说明 |
|---|---|---|
| PHP | ≥ 8.2（推荐 8.2.9） | NTS 版本，需开启 pdo_mysql、openssl、mbstring 扩展 |
| MySQL | ≥ 8.0 | 远程或本地均可，建库 centersql |
| Node | ≥ 18（可选） | 仅前端静态资源构建时需要，非必需 |
| 扩展 | — | pdo_mysql / openssl / mbstring / json / fileinfo |
环境检查命令
# 检查 PHP 版本与扩展 $ php -v $ php -m | grep -E "pdo_mysql|openssl|mbstring" ✓ 无需 Composer，PHP 就绪即可开始
02 / INSTALL
获取代码，直接启动。
无需 Composer，git 拉取代码（或直接下载压缩包），进入目录启动 webman。
获取并启动 webman
# 方式一：Git 克隆（含 vendor 依赖） $ git clone https://tphelp.cn/tphelp/webman.git api # 方式二：下载 zip 解压 $ 下载 tphelp-webman.zip 并解压到 api/ # 进入目录启动 $ cd api $ php start.php start ✓ listening on 8787
配置环境变量
# 复制 .env 示例 $ cp .env.example .env # 编辑数据库连接 DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=centersql DB_USERNAME=root DB_PASSWORD=*** ✓ 敏感信息不进代码
03 / DATABASE
初始化数据库，30 表就位。
执行迁移，30 张共享表自动创建。
01
建库
在 MySQL 中创建 centersql 数据库，字符集 utf8mb4。
02
迁移
执行迁移命令，30 张共享表自动就位。
03
种子
初始化超级管理员账号、基础角色、默认菜单。
迁移与种子命令
# 创建数据库（utf8mb4） CREATE DATABASE centersql DEFAULT CHARSET utf8mb4; # 执行迁移（30 表） $ php migrate:run # 初始化种子数据 $ php seed:run ✓ 30 张表 + 初始数据就位
04 / CONNECT SPA
连接 SPA，菜单自动加载。
配置 layuiAdmin 的 apiBase 指向 webman，登录后台菜单自动加载。
1
配置 apiBase
编辑 layuiadmin/res/config.js，把 apiBase 指向 webman API 地址。
// config.js
window.apiBase = 'http://127.0.0.1:8787';
window.interceptor = false;
2
登录后台
用种子初始化的超级管理员账号登录，菜单按 role_id 自动加载。
登录 → token 签发 → 菜单树返回
→ layuiAdmin 渲染菜单
05 / FAQ
常见问题。
启动时报端口占用？
修改 start.php 中的端口配置，或先结束占用 8787 端口的进程再启动。
菜单加载不出来？
检查 config.js 的 apiBase 是否正确、interceptor 是否为 false、后端是否返回 children + url 字段。
数据库连不上？
确认 .env 中的 DB_HOST/DB_PORT/DB_DATABASE/账号密码正确，且远程 MySQL 允许该 IP 连接。
Token 过期怎么办？
Token 有效期为 8h，过期后重新登录即可；管理员也可主动吊销 Token。