开始使用

本页给出从仓库到可登录开发环境的最短路径。生产环境请同时阅读部署清单和开发与部署指南。

环境准备

• PHP 8.1 或更高版本（后端要求 PHP 8.0+）。
• Composer。
• MySQL 8。
• Node.js 与 pnpm（管理端前端使用）。

支付和 OAuth 场景还需要 cURL、OpenSSL；XLSX 导出需要 ZipArchive；手机号和中文校验使用 mbstring。

克隆与配置

git clone <repo-url>
cd peanut-admin

cd server
cp .env.example .env
# 编辑 .env，填写 DB_* 和随机 JWT_SECRET
composer install
cd ..

创建一个空的 MySQL 数据库：

mysql -u root -p -e "CREATE DATABASE peanut_admin CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

安装基础结构、增量迁移和种子数据：

php server/database/install.php

安装器只接受空数据库。已有环境请备份后，按迁移文件名顺序执行尚未应用的 SQL，不要重复运行首次安装器。

启动服务

终端 A 启动 ThinkPHP 后端：

cd server
php think run --host 0.0.0.0 --port 8000

终端 B 启动管理端前端：

cd web
pnpm install
pnpm dev

打开 http://localhost:5173。开发安装器创建的管理员账号仅用于本地环境；首次登录后请立即修改密码。

下一步

• 需要理解目录和分层时，阅读开发与部署指南。
• 需要执行后台业务操作时，阅读管理员使用手册。
• 只查接口响应和认证规则时，阅读API 约定。