后端常用命令

php think swoole        # 启动 Swoole 服务
php think clear:cache   # 清除系统缓存
php think reset:admin   # 重置后台管理员密码
php -l <file>           # PHP 语法校验（改完 php 文件必做）

---

Swoole 服务配置

配置文件：config/swoole.php

配置项	配置值	说明
HTTP 开发端口	20697	本地或开发机直接监听端口
生产代理端口	20698	生产环境 Nginx 反向代理转发目标端口
热更新	APP_DEBUG=true 时自动启用	代码修改后自动重启 Worker
连接池	DB + Cache 默认启用	提升 Swoole 运行性能

---

生产环境架构与部署

┌─────────────────────────────────────────┐
│  Supervisor                             │
│  └── php think swoole                   │
│       ├── HTTP: 127.0.0.1:20698         │
│       └── WebSocket: 127.0.0.1:20698/ws │
│                                         │
│  Nginx                                  │
│  ├── /adminapi/* → 127.0.0.1:20698      │
│  ├── /api/*      → 127.0.0.1:20698      │
│  ├── /storeapi/* → 127.0.0.1:20698      │
│  └── 静态文件    → public/              │
└─────────────────────────────────────────┘

• Web 根目录：public/
• Supervisor 守护：ebaozu_v4:ebaozu_v4_00 守护 php think swoole
• Nginx 反代：将动态请求反向代理到 127.0.0.1:20698

---

前端构建指南

各前端详细构建命令见对应目录 AGENTS.md：

• 总管理后台：view/admin/AGENTS.md（npm run serve / npm run build）
• 门店后台：view/store/AGENTS.md（npm run serve / npm run build）
• 移动端：view/uniapp/AGENTS.md（HBuilderX 或 npm run build:mp-weixin / npm run build:h5）

---

编码规范注意事项

• 文件操作时默认保持原文件编码，其次优先使用 UTF-8 编码。
• 谨防中文字符乱码，改动 PHP/JS 文件后务必进行语法检查。