PHPackages                             yangweijie/asyncio - 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. [Utility & Helpers](/categories/utility)
4. /
5. yangweijie/asyncio

ActiveLibrary[Utility & Helpers](/categories/utility)

yangweijie/asyncio
==================

基于 PHP Fiber 和 Workerman 的异步 IO 扩展包，提供类似 Python asyncio 的功能

00PHP

Since Nov 1Pushed 6mo agoCompare

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

READMEChangelogDependenciesVersions (1)Used By (0)

PHP AsyncIO v2.0.3
==================

[](#php-asyncio-v203)

基于 PHP Fiber 和 Workerman 实现的高性能异步 IO 扩展包，提供类似 Python asyncio 的 API 和功能。

> **v2.0.3 新特性**: Workerman 性能全面优化！自动选择最优事件循环（10-100x性能提升）、多进程模式、完整生产工具！详见 [更新日志](#%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97)

特性
--

[](#特性)

### 核心功能

[](#核心功能)

- 🚀 **基于 PHP Fiber** - 原生协程支持，性能卓越
- ⚡ **完全事件驱动** - 零轮询，充分利用 Workerman 高性能
- 🎯 **并发控制** - gather, wait\_for, 任务管理
- ⏰ **精确定时** - < 0.1ms 延迟，Timer 事件驱动
- 🛡️ **异常处理** - 完整的错误传播和处理
- 📦 **简洁API** - 类似 Python asyncio 的使用体验

### 生产工具

[](#生产工具)

- 🚀 **Event Loop Auto-Selection** - 自动选择最优事件循环（Ev/Event/Select） *(v2.0.3)*
- 🔄 **Multi-Process Mode** - 多进程模式，充分利用多核 CPU *(v2.0.3)*
- 🚦 **Semaphore** - 信号量并发控制 *(v2.0.3)*
- 💊 **HealthCheck** - 应用健康检查 *(v2.0.3)*
- 🛑 **GracefulShutdown** - 优雅关闭处理 *(v2.0.3)*
- 📏 **ResourceLimits** - 资源限制管理 *(v2.0.3)*
- 📊 **AsyncIO Monitor** - 实时监控任务、内存、性能指标
- 🐛 **AsyncIO Debugger** - 追踪 Fiber 调用链，可视化调用栈
- 🌐 **AsyncIO HTTP Client** - 完整的异步 HTTP 客户端（支持 SSL、重定向等）
- 🔧 **Performance Monitor** - 任务计时、慢任务追踪、Prometheus 导出 *(v2.0.2)*
- 🔗 **Connection Pool** - HTTP 连接池管理和统计 *(v2.0.2)*
- 🧹 **Auto Fiber Cleanup** - 自动清理已终止的 Fiber，防止内存泄漏 *(v2.0.2)*

安装
--

[](#安装)

```
composer require pfinalclub/asyncio

```

要求
--

[](#要求)

- **PHP >= 8.1** （需要 Fiber 支持）
- Workerman >= 4.1

⚡ 性能优化指南
--------

[](#-性能优化指南)

### 事件循环优化 *(v2.0.3)*

[](#事件循环优化-v203)

AsyncIO 自动选择最优事件循环，性能差异可达 **10-100 倍**！

#### 事件循环对比

[](#事件循环对比)

事件循环并发能力性能安装方法**Select**< 1K基准 (1x)默认内置**Event** (libevent)> 10K3-5x`pecl install event`**Ev** (libev)> 100K10-20x`pecl install ev` ⭐推荐#### 性能测试结果

[](#性能测试结果)

```
测试场景: 100个并发任务
┌──────────┬─────────┬──────────┬───────────┐
│ 事件循环 │ 耗时(s) │ 吞吐量   │ 相对性能  │
├──────────┼─────────┼──────────┼───────────┤
│ Select   │  1.25   │ 80/s     │ 1x        │
│ Event    │  0.31   │ 322/s    │ 4x ⚡     │
│ Ev       │  0.12   │ 833/s    │ 10.4x 🚀 │
└──────────┴─────────┴──────────┴───────────┘

```

#### 安装推荐扩展

[](#安装推荐扩展)

```
# macOS
brew install libev
pecl install ev

# Ubuntu/Debian
sudo apt-get install libev-dev
pecl install ev

# CentOS/RHEL
sudo yum install libev-devel
pecl install ev

```

运行时会自动检测并提示：

```
⚠️  使用 Select 事件循环 - 基础性能 ( 8,    // 8个进程
    'name' => 'AsyncIO',
]);

```

**性能对比**:

- 单进程: 1000 QPS
- 8进程: 8000 QPS (8倍提升)

更多详情见 [生产环境部署](#%E7%94%9F%E4%BA%A7%E7%8E%AF%E5%A2%83%E9%83%A8%E7%BD%B2)

快速开始
----

[](#快速开始)

### 基础示例

[](#基础示例)

```