开发环境搭建

本篇把本机跑通后端与管理端开发环境。装完可按 快速开始 走安装向导，再做 第一个业务模块。

环境要求

• PHP 8.4（pdo_mysql、redis、pcntl、posix）
• MySQL 8
• Redis
• Composer 2
• Node 20 与 pnpm（改管理端时需要）

后端

cd server
composer install
cp .env.example .env
php start.php start

php start.php start 同时拉起 HTTP、定时任务、队列和 WebSocket。默认监听 http://127.0.0.1:8000。生产用 php start.php start -d。队列消费进程由 webman/redis-queue 插件随启动一并注册，无需再单独启动队列命令。

尚未安装过时，浏览器打开 http://127.0.0.1:8000/install/ 完成初始化；装完执行 php start.php restart。管理后台入口是 http://127.0.0.1:8000/admin/。

管理端

cd admin
pnpm install
pnpm dev

开发服务器默认端口 5174（可用环境变量 VITE_APP_PORT 覆盖）。/adminapi、/storage、/static 代理到 VITE_APP_API_URL，未设置时回退 http://test.com；/ws 代理到 VITE_APP_WS_TARGET，未设置时回退 ws://127.0.0.1:8001。请在 admin/.env.development（或对应 env）里把 VITE_APP_API_URL 指到本机后端（例如 http://127.0.0.1:8000）。