PHPackages deepziyu/yii2-swoole - 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. deepziyu/yii2-swoole ActiveLibrary[Framework](/categories/framework) deepziyu/yii2-swoole ==================== full solutions making yii2-framework run on swoole with coroutine v0.1.2(7y ago)8619516[3 issues](https://github.com/deepziyu/yii2-swoole/issues)BSD-3-ClausePHPPHP >=7.0.13 Since Sep 5Pushed 7y ago5 watchersCompare [ Source](https://github.com/deepziyu/yii2-swoole)[ Packagist](https://packagist.org/packages/deepziyu/yii2-swoole)[ RSS](/packages/deepziyu-yii2-swoole/feed)WikiDiscussions master Synced 2w ago READMEChangelog (3)Dependencies (4)Versions (7)Used By (0) yii2-swoole =========== [](#yii2-swoole) *为赋予 Yii2 框架协程异步能力而生。* *后期开发会依赖 [Swoft 框架](https://github.com/swoft-cloud) 去实现功能，相信 Swoft 会是下一代优秀的框架。* 此插件基于 swoole (v2.0) 底层实现的协程，改造 Yii2 的核心代码，使开发者无感知，以及在不改动业务代码的情况下，用上 swoole 的异步IO能力。 特性 -- [](#特性) - 协程 MySQL 客户端、连接池，支持主从、事务。 - 协程 Redis 客户端、连接池、缓存 （目前未打算支持事务） - 协程 HttpClient , 依赖于 Swoft 实现 - swoole\_table 缓存组件 - 异步文件日志组件 - 业务代码和 swoole 主进程分离 安装 -- [](#安装) #### 环境要求 [](#环境要求) 1. hiredis 2. composer 3. PHP7.X 4. Swoole2.1 且开启协程和异步 Redis #### swoole install [](#swoole-install) - 参考 - 参考 #### composer install [](#composer-install) - 在项目中的 `composer.json` 文件中添加依赖： ``` { "require": { "deepziyu/yii2-swoole": "*" } } ``` - 执行 `$ php composer.phar update` 或 `$ composer update` 进行安装。 配置 -- [](#配置) 你可以参考 [这个示例项目](https://gitee.com/lizhenju/yii2-swoole-demo) 新建一个启动文件即可。 启动文件清晰的展现出本插件的工作、流程原理。动手写这个文件有助于你更加理解本插件。 swoole.php 示例如下： ``` defined('YII_DEBUG') or define('YII_DEBUG', true); defined('YII_ENV') or define('YII_ENV', 'dev'); defined('WEB_ROOT') or define('WEB_ROOT', dirname(__DIR__) . '/web'); //web目录的路径，用户访问的静态文件都放这里 require(__DIR__ . '/../../vendor/autoload.php'); $config = [ 'id' => 'api-test-hello', 'setting' => [ // swoole_server 的配置。 // @see 其他配置项见 https://wiki.swoole.com/wiki/page/274.html 'daemonize'=>0, 'worker_num'=>2, 'task_worker_num' => 1, 'log_file' => __DIR__.'/../runtime/logs/swoole.log', 'log_level'=> 0, 'chroot' => '/', ], 'cacheTable' => function (){ // swoole_table 需要提前启动，大小为 2 的次方 return deepziyu\yii\swoole\cache\SwooleCache::initCacheTable(1024); }, 'bootstrap' => [ 'class' => 'deepziyu\yii\swoole\bootstrap\YiiWeb', 'config' => function(){ // 用闭包是为了延迟加载 // 返回 Yii 的各个组件的配置 require_once(__DIR__ . '/../../vendor/autoload.php'); require_once(__DIR__ . '/../../yii-swoole/Yii.php'); require(__DIR__ . '/../config/bootstrap.php'); $config = yii\helpers\ArrayHelper::merge( require(__DIR__ . '/../config/main.php'), require(__DIR__ . '/../config/main-local.php'), [ 'components' => [ 'errorHandler' => [ 'class'=>'deepziyu\yii\swoole\web\ErrorHandler' ], 'cache' => [ 'class' => 'deepziyu\yii\swoole\cache\SwooleCache', ], ], ] ); return $config; }, ], ]; // 配置了这么多，最终还是逃不过一 run() deepziyu\yii\swoole\server\Server::run($config); ``` 启动 -- [](#启动) ``` php swoole.php start|stop|reload|reload-task ``` Usage HttpClient ---------------- [](#usage-httpclient) HTTP 客户端的使用请参考 [Swotf 文档](https://doc.swoft.org/http.html)。 TODO ---- [](#todo) - MysqlPool 目前不支持事务 (transaction)。 ( 已实现 ) - MysqlPool、RedisPool 连接池用满了，目前是用 sleep() 进行排队等待，超过等待次数后，报异常。 - MysqlPool 目前不支持主从。 ( 已实现 ) 已知Bug ----- [](#已知bug) - 迭代器将导致协程挂起。 BUG代码： ``` $models = User::find()->each(10); foreach ($models as $model) { // Hang up in this row $data[] = $model->toArray(); } ``` 已解决Bug ------ [](#已解决bug) - new ActiveRecord(\[\]); 中会触发 \_\_set() 魔术方法中调用协程Client，导致两个问题： 1、 首次实例化会导致协程挂起。 2、 如果 SQL 报错直接导致 work 进程终止。 BUG代码： ``` class OneModel extend ActiveRecord{ public static function tableName() { return 'some-table do not exist'; } } //导致进程终止 $model = new OneModel([ 'some-att'=>'some-value', ]); ``` 链接 -- [](#链接) [gitee 仓库](https://gitee.com/lizhenju/yii2-swoole) [github 仓库](https://github.com/deepziyu/yii2-swoole) Chat && Help -------------------- [](#chat--help) Swoft 框架QQ交流群:548173319 ### Health Score 30 — LowBetter than 62% of packages Maintenance19 Infrequent updates — may be unmaintained Popularity27 Limited adoption so far Community10 Small or concentrated contributor base Maturity52 Maturing project, gaining track record How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~64 days Recently: every ~80 days Total 6 Last Release 2899d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/13025775?v=4)[deepziyu](/maintainers/deepziyu)[@deepziyu](https://github.com/deepziyu) --- Tags coroutineswooleyii2-extension ### Embed Badge ![Health badge](/badges/deepziyu-yii2-swoole/health.svg) ``` [![Health](https://phpackages.com/badges/deepziyu-yii2-swoole/health.svg)](https://phpackages.com/packages/deepziyu-yii2-swoole) ``` ### Alternatives [yiisoft/yii2-app-advanced Yii 2 Advanced Project Template 1.7k960.6k5](/packages/yiisoft-yii2-app-advanced)[yiisoft/yii2-redis Redis Cache, Session and ActiveRecord for the Yii framework 44912.1M264](/packages/yiisoft-yii2-redis)[yiisoft/yii2-app-basic Yii 2 Basic Project Template 6761.8M8](/packages/yiisoft-yii2-app-basic)[yiisoft/yii2-apidoc API Documentation generator for the Yii framework 2.0 260712.7k31](/packages/yiisoft-yii2-apidoc)[fancyecommerce/fec fancy ecommerce 2212.1k2](/packages/fancyecommerce-fec) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)