ThinkPHP8框架集成Swoole实现高性能RPC服务

介绍

RPC 即远程过程调用（Remote Procedure Call），是一种分布式计算技术，允许一个程序在不同的计算机上调用另一个程序的函数或方法，就像调用本地程序中的函数一样简单。RPC 隐藏了底层网络通信的细节，使得开发者能够像处理本地调用一样处理远程调用。

分布式调用

解决分布式系统中，服务之间的调用问题。远程调用时，要能够像本地调用一样方便，让调用者感知不到远程调用的逻辑。节点角色：

• Server: 暴露服务的服务提供方
• Client: 调用远程服务的服务消费方
• Registry: 服务注册与发现的注册中心

Think-Swoole 中已经实现了的基于 TCP 的 PRC，这样我们使用传统型框架也可以做简单的分布式架构应用了。

PHP 扩展安装

• 已经编译安装 Swoole 扩展
• 不能安装 Xdebug 扩展

依赖包安装

composer require topthink/think-swoole

安装完成后会在项目 config 配置目录生成 swoole 配置文件 swoole.php

服务端

以下配置都是在config/swoole.php 配置文件中配置

HTTP 服务配置

开启 RPC 并注册服务

1、配置

2、定义 RPC 接口抽象方法

3、定义 RPC 服务类，继承 RPC 接口

<?php

declare(strict_types=1);

namespace app\rpc\service;

use app\rpc\contracts\UserInterface;

class UserSerivce implements UserInterface
{
    public function add($name)
    {
        return "【修改】你添加名称是：" . $name;
    }

    public function list()
    {
        return "list";
    }
}

为什么一定要写 interface，不直接实现功能？

think\swoole\rpc\server\Dispatcher下prepareServices方法看下就懂 （系统定义就必须要这么写） 自我理解 这么写的好处 大型项目经理直接写完下面实现。

开启服务（服务端）

# php think swoole start
Starting swoole http server...
Swoole http server started: <http://0.0.0.0:8787>
You can exit with `CTRL-C`

客户端

以下配置都是在config/swoole.php 配置文件中配置

HTTP 服务配置

配置 RPC 文件配置服务端连接信息

1、配置文件

2、执行命令生成 RPC 服务接口

php think rpc:interface

以上命令执行成功后，会在项目 app 下生成一个rpc.php的文件，它就是 RPC 服务接口调用文件了。rpc.php 文件内容

<?php

/**
 * This file is auto-generated.
 */

declare(strict_types=1);

namespace rpc\contract\userservice;

interface UserInterface
{
 public function add($name);

 public function list();
}
return ['userservice' => ['rpc\contract\userservice\UserInterface']];

注意看下最后的 return 中，就是每个服务接口的命名空间了；在控制器中使用该命名空间实例对象就可以调用

3、实际调用过程

参考代码

use rpc\contract\userservice\UserInterface;
...
public function rpctest(UserInterface $userInterface)
{
 return $userInterface->add('Tinywan');
}

4、客户端请求访问

热更新

由于Swoole服务运行过程中 PHP 文件是常驻内存运行的，这样可以避免重复读取磁盘、重复解释编译 PHP，以便达到最高性能。所以更改业务代码后必须手动reload或者restart才能生效。

think-swoole扩展提供了热更新功能，在检测到相关目录的文件有更新后会自动reload，从而不需要手动进行reload操作，方便开发调试。

如果你的应用开启了调试模式，默认是开启热更新的。原则上，在部署模式下不建议开启文件监控，一方面有性能损耗，另外一方面对文件所做的任何修改都需要确认无误才能进行更新部署。

热更新的默认配置如下：

当我们在应用的根目录下定义一个特殊的.env环境变量文件，里面设置了APP_DEBUG = true会默认开启热更新，你也可以直接把enable设置为 true。

错误

错误一 与 xdebug 冲突

Swoole\Server::start(): Using Xdebug in coroutines is extremely dangerous

php 扩展 xdebug 和 easyswoole 冲突，报警告，此时需要禁用 php 的 xdebug 扩展即可