mirror of
https://gitee.com/hyperf/hyperf.git
synced 2024-12-10 15:53:29 +08:00
130 lines
3.4 KiB
Markdown
130 lines
3.4 KiB
Markdown
# 基於多路複用的 RPC 元件
|
|
|
|
本元件基於 `TCP` 協議，多路複用的設計借鑑於 `AMQP` 元件。
|
|
|
|
## 安裝
|
|
|
|
```
|
|
composer require hyperf/rpc-multiplex
|
|
```
|
|
|
|
## Server 配置
|
|
|
|
修改 `config/autoload/server.php` 配置檔案，以下配置刪除了不相干的配置。
|
|
|
|
`settings` 設定中，分包規則不允許修改，只可以修改 `package_max_length`，此配置需要 `Server` 和 `Client` 保持一致。
|
|
|
|
```php
|
|
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
use Hyperf\Server\Event;
|
|
use Hyperf\Server\Server;
|
|
|
|
return [
|
|
'servers' => [
|
|
[
|
|
'name' => 'rpc',
|
|
'type' => Server::SERVER_BASE,
|
|
'host' => '0.0.0.0',
|
|
'port' => 9502,
|
|
'sock_type' => SWOOLE_SOCK_TCP,
|
|
'callbacks' => [
|
|
Event::ON_RECEIVE => [Hyperf\RpcMultiplex\TcpServer::class, 'onReceive'],
|
|
],
|
|
'settings' => [
|
|
'open_length_check' => true,
|
|
'package_length_type' => 'N',
|
|
'package_length_offset' => 0,
|
|
'package_body_offset' => 4,
|
|
'package_max_length' => 1024 * 1024 * 2,
|
|
],
|
|
'options' => [
|
|
// 多路複用下，避免跨協程 Socket 跨協程多寫報錯
|
|
'send_channel_capacity' => 65535,
|
|
],
|
|
],
|
|
],
|
|
];
|
|
|
|
```
|
|
|
|
建立 `RpcService`
|
|
|
|
```php
|
|
<?php
|
|
|
|
namespace App\RPC;
|
|
|
|
use App\JsonRpc\CalculatorServiceInterface;
|
|
use Hyperf\RpcMultiplex\Constant;
|
|
use Hyperf\RpcServer\Annotation\RpcService;
|
|
|
|
#[RpcService(name: "CalculatorService", server: "rpc", protocol: Constant::PROTOCOL_DEFAULT)]
|
|
class CalculatorService implements CalculatorServiceInterface
|
|
{
|
|
}
|
|
|
|
```
|
|
|
|
## 客戶端配置
|
|
|
|
修改 `config/autoload/services.php` 配置檔案
|
|
|
|
```php
|
|
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
return [
|
|
'consumers' => [
|
|
[
|
|
'name' => 'CalculatorService',
|
|
'service' => App\JsonRpc\CalculatorServiceInterface::class,
|
|
'id' => App\JsonRpc\CalculatorServiceInterface::class,
|
|
'protocol' => Hyperf\RpcMultiplex\Constant::PROTOCOL_DEFAULT,
|
|
'load_balancer' => 'random',
|
|
// 這個消費者要從哪個服務中心獲取節點資訊，如不配置則不會從服務中心獲取節點資訊
|
|
'registry' => [
|
|
'protocol' => 'consul',
|
|
'address' => 'http://127.0.0.1:8500',
|
|
],
|
|
'nodes' => [
|
|
['host' => '127.0.0.1', 'port' => 9502],
|
|
],
|
|
'options' => [
|
|
'connect_timeout' => 5.0,
|
|
'recv_timeout' => 5.0,
|
|
'settings' => [
|
|
// 包體最大值，若小於 Server 返回的資料大小，則會丟擲異常，故儘量控制包體大小
|
|
'package_max_length' => 1024 * 1024 * 2,
|
|
],
|
|
// 重試次數，預設值為 2
|
|
'retry_count' => 2,
|
|
// 重試間隔，毫秒
|
|
'retry_interval' => 100,
|
|
// 多路複用客戶端數量
|
|
'client_count' => 4,
|
|
// 心跳間隔 非 numeric 表示不開啟心跳
|
|
'heartbeat' => 30,
|
|
],
|
|
],
|
|
],
|
|
];
|
|
|
|
```
|
|
|
|
### 註冊中心
|
|
|
|
如果需要使用註冊中心，則需要手動新增以下監聽器
|
|
|
|
```php
|
|
<?php
|
|
return [
|
|
Hyperf\RpcMultiplex\Listener\RegisterServiceListener::class,
|
|
];
|
|
```
|
|
|
|
|