环境要求

以下内容依据当前仓库的 composer.json、web/package.json、miniprogram/package.json 和 .env.example 整理。

后端

• PHP >= 8.2
• Swoole >= 5.0
• MySQL 驱动：ext-pdo_mysql
• Redis 扩展：ext-redis
• 其他必需扩展：
  • ext-bcmath
  • ext-fileinfo
  • ext-json
  • ext-openssl
  • ext-pdo

注意：

• Swoole 需要关闭 Short Name
• 项目依赖 hyperf/async-queue，建议同时准备好 Redis
• 项目依赖 ext-xlswriter，用于导出能力

数据库与缓存

• MySQL >= 5.7，推荐 8.0
• Redis，.env.example 默认使用 6379

管理端

web/package.json 要求：

• Node.js ^20.0.0 || >=21.1.0

小程序 / H5

miniprogram/package.json 当前使用：

• Taro 4.1.11
• React 18.3.1
• TypeScript 5.9.x

建议同时准备：

• Node.js 18+
• 微信开发者工具

Docker

仓库根目录已提供 docker-compose.yml，内含：

• redis:7.2-alpine
• mysql:8.0
• hyperf/hyperf:8.3-alpine-vedge-swoole-v6.1