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 1mo 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)
```

PHPackages © 2026

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