PHPackages jackdou/laravel-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. jackdou/laravel-swoole ActivePackage jackdou/laravel-swoole ====================== laravel 框架的 swoole 组件，基础的TCP，WS 服务 1.2.6(6y ago)51261MITPHPPHP >=7.1 Since Feb 27Pushed 6y ago1 watchersCompare [ Source](https://github.com/jhabc1314/laravel-swoole)[ Packagist](https://packagist.org/packages/jackdou/laravel-swoole)[ RSS](/packages/jackdou-laravel-swoole/feed)WikiDiscussions master Synced today READMEChangelog (10)Dependencies (2)Versions (10)Used By (1) laravel-swoole ============== [](#laravel-swoole) 基于 `swoole` 的 `laravel` `RPC` 扩展包， 目前提供了 `RPC Client` , `RPC Server` 和集群机器节点管理 `server` 功能 使用 -- [](#使用) - 条件 - php >= 7.1 - swoole >= 4.3 - linux 系统环境 - laravel >= 5.5 - 安装 ``` composer require jackdou/laravel-swoole ``` - 配置 - 进入项目根目录 执行 `php artisan vender:publish` - 选择 `Provider: JackDou\Swoole\SwooleServiceProvider` 生成配置文件 - 具体配置内容请根据实际情况在 `config/swoole.php` 中修改 - 配置单个服务多节点的方式(不推荐) - 在 `config/server_node.php` 中可以根据自己的服务名称配置多个机器ip - 可设置权重和在线状态，权重越高分配到的请求也就越多 - 配置的每个机器上都得按下面的方式启动相应的服务 - 如果使用 `management` 管理后台，需要将服务发现方式改为 `2`(推荐) - 启动服务 - `php artisan swoole:server server_name start/stop/reload` //开启、关闭、热重启 server\_name 服务 - 使用 `ps aux | grep 'your server_name' ` 可以查看启动的进程信息 - fpm 中使用同步客户端访问微服务 demo - 编写微服务的业务代码:默认目录为 `app/Services`,新建 TestService.php 类并添加如下内容 ``` namespace App\Services; class TestService { //服务类都需要是静态属性 public static function test($msg = 'hello world') { return ['code' => 1, 'msg' => $msg]; } } ``` - 确保配置文件没问题后启动服务 - 在项目任意可以访问的 `Controller` 中添加如下内容 ``` use JackDou\Swoole\Facade\Service; //getResult 参数为超时时间，单位秒，默认0.5秒。如果服务在0.5秒内没有返回结果则返回null $res = Service::getInstance('swoole')->call('TestService::test', '你好')->getResult(0.5); dd($res); ``` - 浏览器中访问观察效果。 - 若你的 `laravel` 项目使用 `swooletw/laravel-swoole` 等类似组件将框架常驻进程或者在服务的项目代码里可以使用协程异步客户端提高性能 - `Coroutine\Client` 使用 demo ``` namespace App\Services; class TestService { //测试协程客户端 public static function test_co($msg = 'hello world') { //常规调用 try { $co = new SwooleCoClient(); $co->getInstance('swoole') ->call('TestService::test') ->onSuccess(function ($response_data) { //$response_data 响应数据，请求的service返回的数据结构 //在这里处理请求成功返回数据以后的逻辑 })->onFail(function ($err_msg, $err_code) { //请求失败了，在这里记录日志等 })->run(); } catch (\Throwable $throwable) { //寻找服务等发生错误，在这里看原因 } //在一个请求内对一个服务多次调用 try { $co = new SwooleCoClient(); $swoole = $co->getInstance();//同一个服务只用指定一次 $swoole->call('TestService::test') ->onSuccess(function ($response_data) { //$response_data 响应数据，请求的service返回的数据结构 //在这里处理请求成功返回数据以后的逻辑 })->onFail(function ($msg, $code) { //请求失败了，在这里记录日志等 }); $swoole->call('TestService::test_node') ->onSuccess(function ($response_data) { //$response_data 响应数据，请求的service返回的数据结构 //在这里处理请求成功返回数据以后的逻辑 })->onFail(function ($msg, $code) { //请求失败了，在这里记录日志等 }); $swoole->run(); } catch (\Throwable $throwable) { //寻找服务等错误，在这里查看 } //在一个请求内对不同服务调用 try { $co = new SwooleCoClient(); $swoole = $co->getInstance('swoole'); $swoole->call('TestService::test') ->onSuccess(function ($response_data) { //$response_data 响应数据，请求的service返回的数据结构 //在这里处理请求成功返回数据以后的逻辑 })->onFail(function ($msg, $code) { //请求失败了，在这里记录日志等 }); //重新指定另一个服务 $swoole = $co->getInstance('swoole2'); $swoole->call('TestService::test_node') ->onSuccess(function ($response_data) { //$response_data 响应数据，请求的service返回的数据结构 //在这里处理请求成功返回数据以后的逻辑 })->onFail(function ($msg, $code) { //请求失败了，在这里记录日志等 }); $swoole->run(); } catch (\Throwable $throwable) { //寻找服务等错误，在这里查看 } //请求成功一个以后请求另一个服务 try { $co = new SwooleCoClient(); $swoole = $co->getInstance('swoole'); $swoole->call('TestService::test') ->onSuccess(function ($response_data) { //$response_data 响应数据，请求的service返回的数据结构 //在这里处理请求成功返回数据以后的逻辑 $co2 = new SwooleCoClient(); $swoole2 = $co2->getInstance('swoole2'); $swoole2->call('TestService::test_node') ->onSuccess(function ($response_data) { //$response_data 响应数据，请求的service返回的数据结构 //在这里处理请求成功返回数据以后的逻辑 })->onFail(function ($msg, $code) { //请求失败了，在这里记录日志等 }); $swoole2->run(); })->onFail(function ($msg, $code) { //请求失败了，在这里记录日志等 }); $swoole->run(); } catch (\Throwable $throwable) { //寻找服务等错误，在这里查看 } //代码在这里返回，此次请求结束，但是上面的服务调用可能还在执行中!!! return ['code' => 1, 'msg' => $msg]; } } ``` - 建议 & 注意 - 默认是非守护进程方式启动， 推荐使用 `supervisor` 管理 `swoole` 进程 - `v1.2.2` 后支持通过 `.env` 文件区分测试环境和正式环境监听的服务 `ip` 和 `port` - 改动配置或服务代码后必须 `reload` 或重启服务进程，不然不会生效 - `php` `fpm` 和 `cli` 的 `php.ini` 通常不是一个文件，在 `fpm` 中使用时需要保证对应的 `php.ini` 文件中添加了 `swoole` 扩展 - 异步协程客户端在非密集型 `cpu io` 的场景下可以提高性能，推荐使用，但是注意异步代码的执行逻辑和编写方式 - 暂不支持传递图片文件等资源 - 迭代计划 - 增加结合 `jackdou/management` 管理后台实现多机器服务下发配置 已实现 [了解详情](https://github.com/jhabc1314/management)（v1.2.1） - 支持基础 `web socket` 功能 - 服务节点检测，自动下线服务 已实现 [了解详情](https://github.com/jhabc1314/management/releases/tag/0.2.4) - 集成 `supervisor` 自动下发配置管理 已实现 [了解详情](http://www.jackdou.top) ### Health Score 30 — LowBetter than 64% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity14 Limited adoption so far Community9 Small or concentrated contributor base Maturity64 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 ~67 days Recently: every ~11 days Total 9 Last Release 2456d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/8ad3995ba32d2f1b072d7d3d2e6837ae9339d74c0c79df06cb1de7cf984eecc5?d=identicon)[SuperHeng](/maintainers/SuperHeng) --- Top Contributors [![jhabc1314](https://avatars.githubusercontent.com/u/17001740?v=4)](https://github.com/jhabc1314 "jhabc1314 (26 commits)") --- Tags laraver-packageswoole ### Embed Badge ![Health badge](/badges/jackdou-laravel-swoole/health.svg) ``` [![Health](https://phpackages.com/badges/jackdou-laravel-swoole/health.svg)](https://phpackages.com/packages/jackdou-laravel-swoole) ``` ### Alternatives [anourvalar/eloquent-serialize Laravel Query Builder (Eloquent) serialization 11320.2M21](/packages/anourvalar-eloquent-serialize)[namu/wirechat A Laravel Livewire messaging app for teams with private chats and group conversations. 54324.5k](/packages/namu-wirechat)[statamic-rad-pack/runway Eloquently manage your database models in Statamic. 135192.6k5](/packages/statamic-rad-pack-runway) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)