1. 对app目录精简:
app
├─ Common // 保留整个文件夹
├─ Exception // 保留整个文件夹
│ └─ Handler
├─ Helper // 保留整个文件夹
├─ Rpc // 保留整个文件夹
├─ Application.php
├─ AutoLoader.php
└─ bean.php
2. 开发环境:
docker run -it --name swoftrpc -p 8307:18307 -v $(pwd):/swoft -w /swoft swoft/alphp:cli sh
# 启一个Mysql:
docker pull mysql:5.7
docker run -it --name mysql -d -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 mysql:5.7
3. 接口服务:
定义接口并实现接口,才能提供RPC服务.
①. Rpc\Lib:服务的公共接口定义目录:
通常只有php接口类.
②. Rpc\Services:具体的服务接口实现类:
里面的类通常实现了Lib中定义的接口.
注:在多个服务中使用时,可以将lib库app/Rpc/Lib移到一个公共的git仓库中,再各个服务通过composer来获取使用.
3.1 定义接口:
①. 服务提供方:
定义好接口格式,存放到公共的lib库里面.
②. 服务调用方:
加载lib库,就能使用接口服务,接口定义和普通接口完全一致.
3.2 接口实现:
①. 一个接口,会存在多种不同的实现,通过一个版本号来标识是那个逻辑实现.
②. 注解@Service:
@Service():version定义接口版本,默认是 1.0.
@Service(version="1.2"):版本为1.2.
③. 不同的实现,需要定义不同的唯一版本号.如果存在相同,加载之后的服务会覆盖之前的服务.
4. 基本配置:
RPC服务启动有单独启动和集成其它服务(Http/Websocket)两种方式.
(1). 单独启动:
app\bean.php:
use Swoft\Rpc\Server\ServiceServer;
return [
'rpcServer' => [
'class' => ServiceServer::class,
// 'port' => 18308, // 如果要自定义端口
],
];
注:
①. 如果是单独启动,无需其它配置直接可以启动.
②. 首先要在bean.php配置RPC.
③. setting启动配置参数,对应swooleServer->setting
(2). Http server启动中集成RPC服务:
return [
'httpServer' => [
'class' => HttpServer::class,
'port' => 18306,
'listener' => [
'rpc' => bean('rpcServer')
]
],
]
注:
①. listener单独监听一个RPC服务,且同时可以监听多个RPC服务.