PHPackages tsingsun/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. tsingsun/yii2-swoole AbandonedArchivedYii2-extension[Framework](/categories/framework) tsingsun/yii2-swoole ==================== run yii2 in swoole coroutine mode 2.3.5(6y ago)1623.8k↓50%25[5 issues](https://github.com/tsingsun/yii2-swoole/issues)PHPPHP >=7.0 Since Dec 15Pushed 6y ago7 watchersCompare [ Source](https://github.com/tsingsun/yii2-swoole)[ Packagist](https://packagist.org/packages/tsingsun/yii2-swoole)[ RSS](/packages/tsingsun-yii2-swoole/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (4)Versions (21)Used By (0) 关于 Yii2 Swoole ============== [](#关于-yii2-swoole) [![Latest Stable Version](https://camo.githubusercontent.com/5dda22db10d5df42f2c05c9a521d3939716ad5f13697bf8d2b6a1d297fa07f40/68747470733a2f2f706f7365722e707567782e6f72672f7473696e6773756e2f796969322d73776f6f6c652f762f737461626c652e737667)](https://packagist.org/packages/tsingsun/yii2-swoole)[![Build Status](https://camo.githubusercontent.com/00e056890fdbd2c9ac78277a8e96113cbc814c881112d936c80c53b05a95073f/68747470733a2f2f7472617669732d63692e6f72672f7473696e6773756e2f796969322d73776f6f6c652e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/tsingsun/yii2-swoole)[![Total Downloads](https://camo.githubusercontent.com/1256fe0857caf2633cddbadd5ce96e87931dbf318b73d3d1d8d98408654ca970/68747470733a2f2f706f7365722e707567782e6f72672f7473696e6773756e2f796969322d73776f6f6c652f646f776e6c6f6164732e737667)](https://packagist.org/packages/tsingsun/yii2-swoole) 本项目是基于[php-swoole扩展](http://www.swoole.com)协程版本,使yii2项目运行在swoole上的一个方案. 通过本项目扩展,可极大的提高原项目并发性.而且可以通过Yii2的全栈框架开发TCP,UDP,WebSocket等网络服务. 基于Swoole4版本后,协程的切换更方便了,也使代码中不需要再使用call\_user\_func替换.yii2-swoole的适应能力越来越强了. 主版本 - Yii 2.0.14以上 - swoole 4.2以上 安装 -- [](#安装) swoole4请直接使用 ``` composer require tsingsun/yii2-swoole ``` 如果您使用的是swoole2版本请使用1.0版本 特点 -- [](#特点) - 高度兼容Yii2项目,不需要改变项目代码. - 一行代码切换协程和非协程环境的支持 - 编写启动脚本,即可享受swoole + 协程带来的高性能的并发服务. - 运行内存表现稳定. - 本地化mysql,redis连接池(协程环境下,非协程链接池意义不大). [文档](./doc/dbpool.md) - 实现了在swoole下的session功能. 使用方法 ---- [](#使用方法) - swoole启动文件 启动文件为服务启动脚本,根据不同的服务类型定制,也可以根据业务来定制,具体请查看运行方式中的各服务器说明. 协程与非协程的切换也在启动脚本中. ``` use \tsingsun\swoole\server\Server; //站点根目录,相当于nginx的root配置 defined('WEBROOT') or define('WEBROOT', __DIR__); defined('YII_DEBUG') or define('YII_DEBUG', true); defined('YII_ENV') or define('YII_ENV', 'dev'); //协程开关,请严格根据您的环境配置 defined('COROUTINE_ENV') or define('COROUTINE_ENV', true); require(__DIR__ . '/../../vendor/autoload.php'); $config = [ 'class'=>'tsingsun\swoole\server\HttpServer', //Swoole的配置,根据实际情况配置 'setting' => [ 'daemonize'=>0, 'max_coro_num'=>3000, 'reactor_num'=>1, 'worker_num'=>1, 'task_worker_num'=>1, 'pid_file' => __DIR__ . '/../runtime/testHttp.pid', 'log_file' => __DIR__.'/../runtime/logs/swoole.log', 'debug_mode'=> 1, 'user'=>'tsingsun', 'group'=>'staff', // 4.0 新增选项 'enable_coroutine' => COROUTINE_ENV ], ]; Server::run($config,function (Server $server){ $starter = new \tsingsun\swoole\bootstrap\WebApp($server); //初始化函数独立,为了在启动时,不会加载Yii相关的文件,在库更新时采用reload平滑启动服务器 $starter->init = function (\tsingsun\swoole\bootstrap\BaseBootstrap $bootstrap) { //需要使用Yii-Swoole项目的Yii文件, require(__DIR__ . '/vendor/tsingsun/yii2-swoole/src/Yii.php'); //原项目的配置文件引入 $config = yii\helpers\ArrayHelper::merge( require(__DIR__ . '/../config/main.php'), require(__DIR__ . '/../config/main-local.php') ); $bootstrap->appConfig = $config; }; $server->bootstrap = $starter; $server->start(); }); ``` - cli控制命令 Usage: php \[startScript\] \[command\] ``` //启动 php http_server.php start //平滑重启,kill方式,需要root权限, php http_server.php reload //关闭 php http_server.php stop ``` - 运行方式 - [HttpServer](doc/httpServer.md):把swoole当成http服务器运行. - [WebSocketServer](doc/WebSocketServer.md):\[废弃,如需要可直接使用swoole原生,请参考示例配置文件\] - TCP/UDP Server --TODO - 开发调试 - 仍然可用基于集成环境如XAMPP等进行调试 - 基于swoole,只需要配置PHP环境,可用XDEBUG,如果是PHPSTORM,在Debug配置swoole运行脚本,点下Debug运行即可. - 在OnWorkStart断点时，请求会被阻塞 - 启用task时,如果断点于task中,则调试请求会被阻塞 - 如果出现页面信息输出至控制台,一般是被直接echo了,可跟踪各输出出口. > 由于swoole2.0以上与xdebug产生冲突(主要是一些协程的客户端类上),导致无法在IDE中调试,比较好的实践应该是在普通PHP环境下开发好,在swoole环境再测试 ### 配合Nginx [](#配合nginx) Swoole没有像 传统的中间件与Nginx的紧密,部分参数需要自己往HTTP Header写..在传统$\_SERVER中的命名方式保留,防止与Header出现命名冲突. ``` server { root /data/wwwroot/; server_name local.swoole.com; location / { proxy_http_version 1.1; proxy_set_header Connection "keep-alive"; proxy_set_header X-Real-IP $remote_addr; proxy_set_header SERVER_NAME $server_name; if (!-e $request_filename) { proxy_pass http://127.0.0.1:9501; } } } ``` 受限 -- [](#受限) 原Yii2的部分功能在swoole环境具有一定限制.具体请查阅[限制说明文档](doc/limit.md) 请仔细理解[swoole的编程需知](https://wiki.swoole.com/wiki/page/851.html),请求无响应大部分来源于此. 对于第三方包的call\_user\_func或call\_user\_func\_array的处理请参考functionReplace.php的处理 改写的组件 ----- [](#改写的组件) 为了适应swoole的内存常驻机制,对Yii的一部分组件的进行了改写,尽量的保持用户不产生额外的代码修改,无感迁移. 一些组件的改写说明请参阅[组件改写说明](doc/component_changes.md) composer问题 ---------- [](#composer问题) Composer的中国镜像存在问题,如果版本获取有问题时,可以用然后指定composer.json ``` "repositories": [ { "type": "composer", "url": "https://asset-packagist.org" } ], ``` ### 联系我 [](#联系我) QQ: 21997272 Q群: 785966704 如果你觉得对您有帮助,可以请我喝咖啡鼓励下我^\_^ [![支付宝](doc/images/a6x00263kcgmmg3ayg4qb8e.png)](doc/images/a6x00263kcgmmg3ayg4qb8e.png) ### Health Score 38 — LowBetter than 85% of packages Maintenance19 Infrequent updates — may be unmaintained Popularity38 Limited adoption so far Community14 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure 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 ~33 days Recently: every ~25 days Total 20 Last Release 2431d ago Major Versions 0.1.1 → 1.0.02018-02-01 1.1.0 → 2.0.12018-08-01 1.0.x-dev → 2.1.12019-01-23 ### Community Maintainers ![](https://www.gravatar.com/avatar/78bae55afca79d056d16701fc34948da0641203a3bb1bbb3b74501ddca8f6e01?d=identicon)[tsingsun](/maintainers/tsingsun) --- Top Contributors [![tsingsun](https://avatars.githubusercontent.com/u/5848549?v=4)](https://github.com/tsingsun "tsingsun (65 commits)") --- Tags coroutineswooleyii2swoolecoroutineyii2 ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/tsingsun-yii2-swoole/health.svg) ``` [![Health](https://phpackages.com/badges/tsingsun-yii2-swoole/health.svg)](https://phpackages.com/packages/tsingsun-yii2-swoole) ``` ### Alternatives [mix/mix PHP CLI mode development framework 1.9k1.2k](/packages/mix-mix)[feehi/yii2-swoole yii2 swoole,让yii2跑在swoole上 3458.3k1](/packages/feehi-yii2-swoole)[skeeks/cms SkeekS CMS — control panel and tools based on php framework Yii2 13825.6k47](/packages/skeeks-cms)[swoole-foundation/yii2-swoole-extension running yii2 web application on swoole server 4312.3k1](/packages/swoole-foundation-yii2-swoole-extension)[luoxiaojun/sw-fw-less Swoole Http Server without framework 165.3k](/packages/luoxiaojun-sw-fw-less) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)