# 娓告????绔??ц?涓?QPS ????ュ?

## 涓???????涓?????瑙?
| 椤圭? | 璇存? |
|------|------|
| 杩????? | Webman (?轰? Workerman)锛?父椹诲?瀛?|
| HTTP ??? | `http://0.0.0.0:6688` |
| Worker ?伴? | `cpu_count() * 4`锛?? 8 ??= 32 涓??绋?? |
| ?版?搴?| MySQL锛?hinkORM锛???ユ? max=20/min=2 |
| 缂?? | Redis锛?hink-cache 榛?? `redis`锛??杩??姹?max=20/min=2 |
| 缂??椹卞?娉ㄦ? | `config/cache.php` 榛?? `file`锛??涓??浣跨?璇ラ?缃??缂??璧版?浠讹?`config/think-cache.php` 榛?? `redis`锛?PI ?ㄦ?/濂????疆绛?娇??Redis |

---

## 浜????蹇???ｄ????姹????
### 2.1 楂?苟????虫???
| ?ュ? | ?ㄩ??| 涓昏???? | 棰?及??????锛??楠??硷? |
|------|------|----------|------------------------|
| `POST /api/game/playStart` | 寮?濮??灞?娓告?锛??濂?? | 澶?? DB + Redis + 浜?? | 楂??瑙??锛?|
| `POST /api/game/buyLotteryTickets` | 璐?拱?藉???| 浜?????琛ㄥ???+ Redis ?存? | 涓?|
| `GET /api/game/config` | 娓告???疆 | ?ㄨ〃 DiceConfig ?ヨ?锛??缂?? | 浣?涓?|
| `GET /api/game/lotteryPool` | 濂????疆 | DiceRewardConfig 缂?? | 浣?|
| `POST /api/v1/getGameUrl` | ?峰?娓告??板?锛?钩?帮? | ?诲??昏? + JWT + Redis | 涓?|
| `POST /api/v1/getPlayerInfo` | ?╁?淇℃? | ??username ??DicePlayer | 浣??寤鸿? username ???涓?绱㈠?锛?|
| `POST /api/v1/getPlayerGameRecord` | 娓告?璁板???〃 | ??〉 + ??? N+1 ?ョ?瀹?| 涓?|
| `POST /api/v1/setPlayerWallet` | ?卞?杞??杞?? | 浜??锛???扮?瀹?+ ???姘?| 涓?|

### 2.2 `playStart` ???璇锋??????В锛??ц??抽?璺??锛?
???娓告?涓?娆¤?姹?ぇ?翠?瑙??锛?
**?版?搴??**

1. `DicePlayer::find($playerId)` ???￠??╁?涓??棰?2. `DiceRewardConfig::getCachedMinRealEv()` ??棣??????ュ?骞跺?缂??
3. `LotteryService::getOrCreate()` ?????涓?Redis ?讹?`DicePlayer::find` + `DiceLotteryPoolConfig::where('type',0/1)->find()` 涓ゆ?
4. `DiceLotteryPoolConfig::find($configId)` ?????缃?ID ???姹?5. **浜????*锛? 
   - `DicePlayRecord::create`  
   - `DicePlayer::find($playerId)`锛??娆℃??╁?锛??浼??锛? 
   - `DicePlayer::save`  
   - ??? `DicePlayerTicketRecord::create`锛?5 涓??锛? 
   - `DiceLotteryPoolConfig::where('id')->update(['ev' => Db::raw(...)])` ??琛?骇?存?  
   - `DicePlayerWalletRecord::create`
6. 浜?????`DicePlayer::find($playerId)`??UserCache::setUser`

**Redis锛?*

- `DiceRewardConfig::getCachedInstance()`锛?? getCachedByTier 绛????璇?????遍?缃??瀛?- `LotteryService::getOrCreate()` ??璇????瀹跺?姹??瀛?- `UserCache::setUser()` ??????蜂俊???瀛?
?ㄧ?瀛??涓??濂界????涓????? `playStart` 浠?害??**6锝? 娆?DB 璁块?**锛??浜????2 娆?find ?╁??? 娆?update 褰╅?姹???锝? 娆?create锛??? 
?ョ?瀛???戒腑锛??浼??????遍?缃????姹??缃????瀹剁??ヨ?娆℃???
---

## 涓????ц??堕?涓???╃?

### 3.1 ?版?搴?
1. **杩??姹?? Worker ??*  
   - ??? DB 杩??姹?max=20锛?orker ??= CPU?4??? 32 涓?Worker ?????弧锛??浜?? 20 涓???ワ??虹?绛??涓???躲?? 
   - 寤鸿?锛??????? `DB_POOL_MAX`锛?? 32锝?4锛??骞剁???MySQL `max_connections` 涓???ヨ???
2. **`playStart` ???澶???╁?**  
   - 浜??澶?凡 `DicePlayer::find($playerId)`锛???″???`DicePlayer::find($playerId)`?? 
   - ???涓哄?浜?????????ㄥ凡??`$player` ????ュ?瑕??娈碉????涓?娆?SELECT??
3. **`DiceLotteryPoolConfig::where('id', $configId)->update(['ev' => Db::raw(...)])`**  
   - 姣???芥??板?涓???疆琛?? `ev`锛??骞跺?涓??琛??绔?????锛???芥?涓虹?棰??? 
   - ?????锛??姝ョ疮??????堕?/娆℃??归??存?锛??浣跨? Redis 璁℃?????跺?姝ュ? DB??
4. **绱㈠?**  
   - `dice_player.username`??dice_play_record.player_id`??dice_play_record.create_time`?? 
     `dice_player_wallet_record.player_id`??dice_player_ticket_record.player_id` 绛????缓绱㈠?锛??琛ㄤ?缁??浼?????? 
   - 寤鸿??冲?锛?username` ???绱㈠?锛?player_id` + `create_time` 缁??绱㈠?锛??瀹???ヨ??′欢寰??锛???
### 3.2 缂??

1. **缂??椹卞?涓????*  
   - `config/cache.php` 榛?? `file`锛??涓?????璇ラ?缃?? Cache锛??璧版?浠讹?QPS 楂?? I/O ???浼??涓虹?棰??? 
   - 寤鸿?锛??浜х?涓?浣跨? Redis锛?苟纭?? `CACHE_MODE=redis` 涓?think-cache ??default 涓??淬??
2. **濂????疆缂??**  
   - `DiceRewardConfig::getCachedInstance()` 宸插???????????+ Redis锛??涓???舵?ц?濂姐?? 
   - ??淇????疆????惰???`refreshCache()`锛?????????锋???
3. **UserCache ??В瀵?*  
   - 姣?? `getUser`/`setUser` ??AES ??В瀵??楂?QPS 涓?CPU 浼?????浣???父涓??棣???堕?锛???????? CPU 楂?????????￠???缉??value??
### 3.3 ??〃?ュ? N+1

- `getPlayerGameRecord`锛????〉??`DicePlayRecord`锛?? `whereIn('id', $playerIds)` ?ョ?瀹跺苟缁???? 
  褰??瀹??宸插??归??ョ?瀹讹?涓???稿? N+1锛???ュ?椤?limit 寰?ぇ浠????????蹇??瀛???????limit 涓??锛?凡??100 涓??锛??? 
- `getPlayerWalletRecord` / `getPlayerTicketRecord` 浣跨? `with(['dicePlayer'])` 棰??杞斤??????
### 3.4 杩??涓????
- Worker ??= CPU?4 ?讹??ユ?涓??姹????1 涓?DB 杩??涓??姹???撮?锛?0 涓???ユ?琚??婊°?? 
- 寤鸿?锛?????涓??瀵?`DB_POOL_WAIT_TIMEOUT` ???缁?父瑙??锛???冲????澧?ぇ姹????????浜????
---

## ????PS 棰?及锛??楠??硷???????″?锛?
### 4.1 ????′欢

- 8 ??CPU锛?2 涓?Worker??- MySQL/Redis ??????寤惰????锛??纾???堕???- 缂???戒腑???锛???遍?缃???otteryService??serCache 澶?负?戒腑锛???
### 4.2 ????ｇ?绠?
- **playStart**锛??娆＄害 50锝?50 ms锛??浜??涓??娆?DB/Redis锛????Worker 绾?7锝?0 QPS锛?2 Worker 绾?**220锝?40 QPS**?? 
  瀹????DB 琛??锛?? `dice_lottery_config.ev` ?存?锛?????ユ?绛??褰卞?锛?*淇??浼拌???? 200锝?00 QPS**??- **buyLotteryTickets**锛??娆＄害 20锝?0 ms锛???虹害 **500锝?000+ QPS**锛?互杩??姹?????婊′负???锛???- **getGameUrl / 骞冲??ュ?**锛??璧??褰?? DB ?ヨ?锛??娆＄害 30锝?0 ms锛???虹害 **400锝?00 QPS**锛?????璧扮?瀛????
### 4.3 娣峰?娴??

??70% 涓?`playStart`??0% 涓哄?浠???ｏ??翠???? QPS 浼?? `playStart` ?炬?锛?*缁煎????绾?250锝?00 QPS** ???涓哄?????淬?? 
瀹??????ab/wrk/k6 绛?? `playStart` ??富瑕???ｅ?娴??缁?? MySQL ?㈡?璇???edis ?戒腑??????ユ?绛??娆℃????????
---

## 浜??????缓璁????
| 绫诲? | 寤鸿? |
|------|------|
| ??疆 | ??骇璁剧疆 `CACHE_MODE=redis`锛?苟缁??浣跨? Redis 浣?负 Cache 椹卞? |
| 杩??姹?| ??? `DB_POOL_MAX`锛?? 32锝?4锛??淇?? ??Worker ?帮?骞剁???MySQL max_connections |
| 浠ｇ? | `playStart` 浜??????ㄥ凡?ョ? `$player`锛?????娆?`DicePlayer::find($playerId)` |
| ?版?搴?| 涓?`username`??player_id`??create_time` 绛??棰??璇㈠?娈靛?绱㈠??????储寮?|
| ????存? | `dice_lottery_config.ev` ???灞??存??逛负 Redis 绱?? + 瀹??/?归???? DB锛??浣?????浜?|
| ??? | 瀵?`playStart`??buyLotteryTickets`??setPlayerWallet` ?????涓??璇?????锛?苟??MySQL ?㈡?璇??杩??姹??寰????|
| ??? | 浣跨? ab/wrk/k6 瀵?`/api/game/playStart` 绛???舵????锛???板???P99 寤惰?涓??澶?QPS |

---

## ?????浣???扮?瀹?QPS 涓?P99

1. **??? playStart**  
   - 浣跨???? JWT锛??????诲??垮? token锛??瀵?`POST /api/game/playStart` ??body `direction=0` ??`1`?? 
   - 绀轰?锛???挎? URL ??token锛??  
     ```bash
     # 浣跨? ab
     ab -n 1000 -c 32 -p post_body.json -T application/json -H "token: YOUR_JWT" http://127.0.0.1:6688/api/game/playStart

     # 浣跨? wrk锛?? lua ???浼?token ??body锛?     wrk -t4 -c32 -d30s -s play_start.lua http://127.0.0.1:6688/api/game/playStart
     ```
   - 浠????腑寰?? Requests per second锛?PS锛?? Time per request锛???㈢? P99 ?ュ伐?锋??????
2. **??????**  
   - 搴??锛??涓???ｇ?璇锋?????钩?? P99 ?????xx 涓???舵??般?? 
   - MySQL锛???ユ?????ヨ???nnoDB 琛??绛???? 
   - Redis锛???ユ????涓?????浠よ?????
3. **?堕??ゆ?**  
   - ??QPS 涓????CPU ???婊???浼?????浠ｇ?????哄??? 
   - ??DB 杩??绛??????ヨ?澧?? ????储寮?????????杩??姹???????〃?? 
   - ??Redis 寤惰?涓?? ???ュぇ key????戒护???缁??杩??姹???
---

## 涓????浣??楂??ц?锛????????

??*???浜у?姣?*浠???颁????锛????????椤瑰?????炬???QPS 涓?ǔ瀹??с??
### 7.1 ??疆灞???归?缃???????唬??????

| 浼??绾?| ??? | 璇存? |
|--------|------|------|
| 楂?| ??骇???璁剧疆 `CACHE_MODE=redis` | ?垮?璧版?浠剁?瀛????? I/O 涓??绔??锛?? think-cache 淇??涓??淬??|
| 楂?| ??? DB 杩??姹??`DB_POOL_MAX=32` ??`64` | 淇?? ??Worker ?帮?濡?32锛???垮?楂?苟???杩??绛??涓???躲??|
| 涓?| ??? Redis 杩??姹??`REDIS_POOL_MAX=32` | 涓?Worker ?板??????? Redis ?峰?杩??绛????|
| 涓?| 纭?? MySQL `max_connections` ??搴??杩??姹??诲? | 澶??渚??缃叉?锛??渚?? ? DB_POOL_MAX ?胯?杩?MySQL 涓????|

**绀轰? .env ???锛?*

```env
CACHE_MODE=redis
DB_POOL_MAX=32
DB_POOL_MIN=4
REDIS_POOL_MAX=32
```

### 7.2 ?版?搴??锛??绱㈠???????

| 浼??绾?| ??? | 璇存? |
|--------|------|------|
| 楂?| 涓?`dice_player.username` 寤哄?涓?绱㈠? | ?诲???etPlayerInfo??oken 涓??浠跺???username ?ワ???储寮???ㄨ〃?????|
| 楂?| 涓?`dice_play_record(player_id, create_time)` 寤虹???储寮?| 娓告?璁板???〃???璁℃??╁?+?堕??ヨ?锛?????椤典?缁????|
| 涓?| 涓烘?姘磋〃 `player_id`??create_time` 寤虹储寮?| 濡?`dice_player_wallet_record`??dice_player_ticket_record` ???瀹舵??堕?绛?????ㄥ?涓???|

**绀轰? SQL锛??瀹??琛ㄥ?璋??锛??**

```sql
-- ?ュ?????ㄥ?娣诲?
ALTER TABLE dice_player ADD UNIQUE INDEX uk_username (username);
ALTER TABLE dice_play_record ADD INDEX idx_player_create (player_id, create_time);
ALTER TABLE dice_player_wallet_record ADD INDEX idx_player_create (player_id, create_time);
ALTER TABLE dice_player_ticket_record ADD INDEX idx_player_create (player_id, create_time);
```

### 7.3 浠ｇ?灞????? DB 璋??涓???归?锛?
| 浼??绾?| ??? | 璇存? |
|--------|------|------|
| 楂?| `playStart` 浜??????ㄥ凡?ョ? `$player`锛????`DicePlayer::find($playerId)` | 灏?1 娆?SELECT锛???″??ㄥ?涓? `$player` ???瀛????? 1 娆?SELECT??|
| 涓?| `game/config` ?ュ?涓?DiceConfig ???瀛?| ??疆???棰??浣????Redis 缂?? 1锝? ???锛??灏??琛ㄦ?璇???|
| 涓?| `dice_lottery_config.ev` ?逛负 Redis 绱?? + 瀹????? DB | 姣??涓?? `UPDATE dice_lottery_config SET ev=ev-?`锛?????琛???归?锛??姣?????姣?N 灞????涓?娆°??|

### 7.4 ???涓????
| 浼??绾?| ??? | 璇存? |
|--------|------|------|
| 涓?| 瀵?`playStart`??buyLotteryTickets` ?????涓??璇????? | 渚夸?????㈣?姹??寮?父娴????|
| 涓?| 寮???MySQL ?㈡?璇㈡?蹇??濡?>200ms锛?| 瀹??????储寮??浼????SQL??|
| 浣?| ???寰????? QPS 涓?P99 | ??ab/wrk/k6 瀵?`playStart` ???锛?互?版?瀹??????╁??舵???|

### 7.5 棰?????锛??楠??硷?

- ??疆灞?+ 绱㈠?锛???ヤ????涓虹?棰????〃涓??褰???ｆ??惧?蹇???翠??????害 **20%锝?0%** ??? QPS??- ?绘? playStart ??2 娆″?浣??搴?????姹?? 2 娆?round-trip锛?*playStart ???姹????绾?? 5%锝?5%**??- ev ?逛负 Redis 绱??锛??骞跺?涓?**playStart** 琛??绔??涓??锛????playStart QPS ????????**10%锝?0%**锛??骞跺?搴????锛???
---

**璇存?**锛??杩?QPS 涓??????负?轰?浠ｇ?涓??缃??浼扮?锛?????ц?浠ュ?娴??绾夸????涓哄???缓璁??棰??/??骇??????灏??杞?`playStart` 涓??褰????????虫??ｇ??????