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

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

longxinh/swoole
===============

Swoole

9284PHP

Since Jan 28Pushed 7y ago2 watchersCompare

[ Source](https://github.com/longxinH/swoole)[ Packagist](https://packagist.org/packages/longxinh/swoole)[ RSS](/packages/longxinh-swoole/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

SWOOLE
------

[](#swoole)

swoole library

---

环境依赖
----

[](#环境依赖)

> - Swoole 1.8.x+
> - PHP 5.4+
> - Composer

Install
-------

[](#install)

### Install composer

[](#install-composer)

```
 curl -sS https://getcomposer.org/installer | php
```

### Install swoole

[](#install-swoole)

```
cd swoole-src
phpize
./configure
make && make install

```

---

安装
--

[](#安装)

```
composer require "longxinh/swoole:dev-master"

```

---

使用
--

[](#使用)

### TCP Server

[](#tcp-server)

> - 服务继承 `\Swoole\Server\Tcp`
> - `doWork(swoole_server $server, int $fd, int $from_id, string $data)` 方法, 服务在接收 `onReceive` 事件回调时会调用 `doWork` 方法执行自定义逻辑，返回给客户端的格式： `字符串`

```
class TcpServer extends \Swoole\Server\Tcp {

    /**
     * @param array $data
     * @return string
     */
    public function doWork(\swoole_server $server, $fd, $from_id, $data)
    {
        return 'tcp :' . $data;
    }
}

$server = new TcpServer('0.0.0.0:9503', 'tcp');
$server->run(array Swoole 配置);
```

### HTTP Server

[](#http-server)

> - 服务继承 `\Swoole\Server\HTTP`
> - `doRequest(\Swoole\Server\Request $request)` 方法, 服务在接收 `onRequest` 事件回调时会调用 `doRequest` 方法执行自定义逻辑，返回给客户端的格式： `字符串`

```
class HttpServer extends \Swoole\Server\HTTP {

    public function doRequest(\Swoole\Server\Request $request)
    {
        return $request->isPost() ? 'post : ' . json_encode($request->getPost()) : 'get : ' . json_encode($request->getGet());
    }

}

$server = new HttpServer('0.0.0.0:9502', 'http');
$server->run(array Swoole 配置);
```

### RPC Server

[](#rpc-server)

> - 服务继承 `\Swoole\Server\RPC`
> - `doWork(swoole_server $server, int $fd, int $from_id, array $data)` 方法, 服务在接收 `onReceive` 事件回调时会调用 `doWork` 方法执行自定义逻辑，返回给客户端的格式： `经过打包协议的字符串`
> - `doTask(array $data)` 方法, 服务在接收 `onTask` 事件回调时会调用 `onTask` 方法，返回给客户端的格式： `经过打包协议的字符串`，并返回数据给 `onFinish`
> - 服务注册目前提供 `redis` 和 `zookeeper`两种形式，需调用 `addProcess` 新建一个进程注册服务

```
class RpcServer extends \Swoole\Server\RPC {

    /**
     * @param array $data
     * @return array
     */
    public function doWork(\swoole_server $server, $fd, $from_id, $data)
    {
        return Format::packFormat($data['params']);
    }

    /**
     * @param $data
     * @return mixed
     */
    public function doTask($data)
    {
        return Format::packFormat($data['params']);
    }

}

$server = new RpcServer('0.0.0.0:9501', 'rpc');
/*
 * 服务注册
 */
$server->addProcess(
    \Swoole\Console\Process::createProcess(
        \Swoole\Service\Registry::register(
            new \Swoole\Service\Container\Redis('127.0.0.1', '6379'),
            //使用zookeeper作为注册中心
            //new \Swoole\Service\Container\Zookeeper('127.0.0.1', '2181'),
            $server,
            //可自定义服务名称，默认名称为base
            'base'
        )
    )
);
$server->run(array Swoole 配置);
```

### 服务监控中心

[](#服务监控中心)

> - `\Swoole\Service\Registry`
> - `register` 方法, 实现向服务存储容器上报注册信息，提供当前服务 `host` 和 `ip`
> - `watch` 方法, 实现服务监控，检测超时服务，并剔除不可用服务
> - `discovery` 方法, 实现服务发现，在服务存储容器里获取到目前可用服务

### 服务存储容器

[](#服务存储容器)

> - `\Swoole\Service\Container\Redis`
> - `\Swoole\Service\Container\Zookeeper`

```
/*
 * 服务注册
 */
$server->addProcess(
    \Swoole\Console\Process::createProcess(
        \Swoole\Service\Registry::register(
            new \Swoole\Service\Container\Redis('127.0.0.1', '6379'),
            //使用zookeeper作为注册中心
            //new \Swoole\Service\Container\Zookeeper('127.0.0.1', '2181'),
            $server,
            //可自定义服务名称，默认名称为base
            'base'
        )
    )
);
```

---

快速开始
====

[](#快速开始)

```
 composer install

```

运行服务指令
------

[](#运行服务指令)

```
 start | stop | reload | restart | help

```

### 运行服务注册中心

[](#运行服务注册中心)

> - 对注册服务添加到可用服务列表中，并剔除超时服务
> - 由于watch继承于 `\Swoole\Server\HTTP`，可通过浏览器查看可用服务，url输入 `http://127.0.0.1:9569/`

```
 cd __Your swoole path__/examples/monitor/
 php watch.php start
```

### 运行RPC服务

[](#运行rpc服务)

```
 cd __Your swoole path__/examples/service/
 php rpc.php start
```

### RPC客户端

[](#rpc客户端)

```
 cd __Your swoole path__/examples/client/
 php rpc.php
```

License MIT
===========

[](#license-mit)

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/767c0bdd16a4ee87a9d871c441d11bc69c6f249a0e522a54887bc9c7ae84c761?d=identicon)[longxinH](/maintainers/longxinH)

---

Top Contributors

[![longxinH](https://avatars.githubusercontent.com/u/12230340?v=4)](https://github.com/longxinH "longxinH (18 commits)")

---

Tags

swoole

### Embed Badge

![Health badge](/badges/longxinh-swoole/health.svg)

```
[![Health](https://phpackages.com/badges/longxinh-swoole/health.svg)](https://phpackages.com/packages/longxinh-swoole)
```

###  Alternatives

[fntneves/laravel-transactional-events

Transaction-aware Event Dispatcher for Laravel

3202.6M2](/packages/fntneves-laravel-transactional-events)[ipinfo/ipinfo

The official PHP library for IPinfo, the most reliable, accurate, and in-depth source of IP address data available anywhere. We process terabytes of data to produce our custom IP geolocation, company, carrier and IP type data sets. Visit our developer docs at https://ipinfo.io/developers.

2891.2M11](/packages/ipinfo-ipinfo)[typo3/cms-recordlist

TYPO3 CMS Recordlist - Lists database records in the TYPO3 backend module (Web>List).

178.0M48](/packages/typo3-cms-recordlist)[neos/eel

The Embedded Expression Language (Eel) is a building block for creating Domain Specific Languages

122.0M27](/packages/neos-eel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)