PHPackages                             pfinalclub/asyncio-gamekit - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. pfinalclub/asyncio-gamekit

ActiveLibrary[Framework](/categories/framework)

pfinalclub/asyncio-gamekit
==========================

基于 pfinal-asyncio 的轻量级异步游戏逻辑框架

3.0.1(3mo ago)18322MITPHPPHP >=8.1

Since Oct 14Pushed 3mo agoCompare

[ Source](https://github.com/pfinalclub/pfinal-asyncio-gamekit)[ Packagist](https://packagist.org/packages/pfinalclub/asyncio-gamekit)[ RSS](/packages/pfinalclub-asyncio-gamekit/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (5)Versions (7)Used By (0)

pfinal-asyncio-gamekit
======================

[](#pfinal-asyncio-gamekit)

[![Version](https://camo.githubusercontent.com/29e9e0aa8903b409540527372a4aa3eee09f4ba7c2f09cc030a10f25d8823f1d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d332e302e312d626c75652e737667)](https://github.com/pfinalclub/pfinal-asyncio-gamekit)[![PHP Version](https://camo.githubusercontent.com/04744bae0a61d2ffe29c26f07a9612eae20445fc6feaeb77b3af1f0e9be6447c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e312d3838393242462e737667)](https://www.php.net/)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)

> 基于 [pfinal-asyncio](https://github.com/pfinalclub/pfinal-asyncio) 的轻量级异步游戏逻辑框架

一个面向 Workerman + pfinal-asyncio 的异步游戏框架，让你用 `async/await` 编排游戏逻辑，就像写故事剧本一样。

✨ 特性
----

[](#-特性)

### 核心功能

[](#核心功能)

- 🎮 **Room 基类** - 带完整生命周期钩子的异步房间管理
- 👥 **Player 通信封装** - 简单易用的玩家消息收发
- 📢 **异步广播机制** - 支持即时和延迟广播
- ⏰ **定时事件系统** - 灵活的定时器和延迟任务
- 🔄 **房间生命周期** - onCreate、onStart、run、onDestroy 完整钩子
- 🎯 **RoomManager** - 多房间管理和快速匹配
- 🌐 **GameServer** - 开箱即用的 WebSocket 游戏服务器

### 高级功能 🆕

[](#高级功能-)

- 🧪 **单元测试** - 完整的 PHPUnit 测试框架
- 🚨 **异常处理** - 结构化异常系统，带上下文信息
- 📝 **日志系统** - 多级别日志，支持控制台和文件输出
- 💾 **状态持久化** - 支持 Redis、文件等多种存储方式
- ⚖️ **负载均衡** - 多进程房间分配，支持轮询、最少连接等策略

### 框架定位

[](#框架定位)

专为 **小型多人游戏** 和 **实时对战游戏** 设计，适用于：

- 🃏 卡牌游戏
- 🎲 棋牌游戏
- 🎯 答题游戏
- 🏁 实时对战游戏
- 🎮 回合制游戏

📦 安装
----

[](#-安装)

```
composer require pfinalclub/asyncio-gamekit
```

📋 要求
----

[](#-要求)

- PHP >= 8.1
- pfinalclub/asyncio >= 3.0
- workerman/workerman >= 4.1 或 >= 5.0

> **注意**: 如果您的项目已安装 `workerman/workerman v5.x`，请确保 `pfinalclub/asyncio` 也支持 Workerman v5。如果遇到依赖冲突，请使用 `composer require pfinalclub/asyncio-gamekit --with-all-dependencies` 安装。

🚀 快速开始
------

[](#-快速开始)

### 1. 创建你的第一个游戏房间

[](#1-创建你的第一个游戏房间)

```