感谢hyperf 的官方文件讲解的很细
hyperf.wiki/3.0/#/
我这里用的是Windows10系统,安装docker直接用菜鸟教程就行了 www.runoob.com/docker/wind…
一、dcoker 安装heyper 镜像,容器等配置
注意:这里需要启动2个端口,一个是服务者一个是消费者
docker run --name hyperf `
-v D:\phpstudy_pro\WWW\microservice:/data `
-p 9501:9501 -p9502:9502 -it `
--privileged -u root `
--entrypoint /bin/sh `
hyperf/hyperf:8.0-alpine-v3.15-swoole
二、安装heyper服务者项目provider
1.安装hyperf项目与服务者需要的组件
cd data
//安装服务者项目provider
composer create-project hyperf/hyperf-skeleton provider
cd provider
//安装JSON RPC 服务
composer require hyperf/json-rpc
//JSON RPC 服务端
composer require hyperf/rpc-server
//安装服务中心组件我这里用的是nacos
composer require hyperf/service-governance-nacos
2.\app\JsonRpc 在app目录创建JsonRpc目录然后写入2个简单的类
namespace App\JsonRpc;
use Hyperf\RpcServer\Annotation\RpcService;
/**
* 注意,如希望通过服务中心来管理服务,需在注解内增加 publishTo 属性
* publishTo 代表我们选择的服务中心,这里选的是nacos
* name 为自己的类名
*/
#[RpcService(name: "CalculatorService", protocol: "jsonrpc-http", server: "jsonrpc-http",publishTo:"nacos")]
class CalculatorService implements CalculatorServiceInterface
{
// 实现一个加法方法,这里简单的认为参数都是 int 类型
public function add(int $a, int $b): int
{
// 这里是服务方法的具体实现
return $a + $b;
}
}
<?php
namespace App\JsonRpc;
Interface CalculatorServiceInterface{
public function add(int $a, int $b);
}
3.\config\autoload\server.php 在serves中加入
[
'name' => 'jsonrpc-http',
'type' => Server::SERVER_HTTP,
'host' => '0.0.0.0',
'port' => 9504,
'sock_type' => SWOOLE_SOCK_TCP,
'callbacks' => [
Event::ON_REQUEST => [\Hyperf\JsonRpc\HttpServer::class, 'onRequest'],
],
],
4.\config\autoload\services.php 创建services 加入下面代码配置为自己的
注:这里的host可以通过获取容器信息然后找里面的Gateway
<?php
return [
'enable' => [
'discovery' => true,
'register' => true,
],
'consumers' => [],
'providers' => [],
'drivers' => [
'nacos' => [
'host' => '172.17.0.1',
'port' => 8849,
'username' => null,
'password' => null,
'heartbeat' => 5,
],
],
];
到了这里服务者的代码及配置就没了
三、docker安装nacos镜像与容器
docker run --name nacos-server -e MODE=standalone -p 8849:8848 -d nacos/nacos-server
安装好了以后直接访问127.0.0.1:8849/nacos 这里账号和密码默认都是nacos
四、安装heyper消费者项目consumer
1.安装hyperf项目与服务者需要的组件
cd data
//安装服务者项目provider
composer create-project hyperf/hyperf-skeleton consumer
cd provider
//安装JSON RPC 服务
composer require hyperf/json-rpc
//JSON RPC 客户端
composer require hyperf/rpc-client
//安装服务中心组件我这里用的是nacos
composer require hyperf/service-governance-nacos
2.\app\JsonRpc 在app目录创建JsonRpc目录然后写入1个简单的类
<?php
namespace App\JsonRpc;
Interface CalculatorServiceInterface{
public function add(int $a, int $b);
}
3.测试的话就用app的index控制器
<?php
declare(strict_types=1);
/**
* This file is part of Hyperf.
*
* @link https://www.hyperf.io
* @document https://hyperf.wiki
* @contact group@hyperf.io
* @license https://github.com/hyperf/hyperf/blob/master/LICENSE
*/
namespace App\Controller;
use Hyperf\Di\Annotation\Inject;
use App\JsonRpc\CalculatorServiceInterface;
class IndexController extends AbstractController
{
#[Inject]
private CalculatorServiceInterface $CalculatorServiceInterface;
public function index()
{
$num1 = $this->request->input('num1',1);
$num2 = $this->request->input('num2',1);
return $this->CalculatorServiceInterface->add((int)$num1 , (int)$num2);
$user = $this->request->input('user', 'Hyperf');
$method = $this->request->getMethod();
return [
'method' => $method,
'message' => "Hello {$user}.",
];
}
}
4.\config\autoload\server.php 将serves中端口改为 9502
5.\config\autoload\services.php 创建services 加入下面代码配置为自己的
<?php
return [
// 此处省略了其它同层级的配置
'consumers' => [
[
// name 需与服务提供者的 name 属性相同
'name' => 'CalculatorService',
// 服务接口名,可选,默认值等于 name 配置的值,如果 name 直接定义为接口类则可忽略此行配置,如 name 为字符串则需要配置 service 对应到接口类
'service' => \App\JsonRpc\CalculatorServiceInterface::class,
// 对应容器对象 ID,可选,默认值等于 service 配置的值,用来定义依赖注入的 key
'id' => \App\JsonRpc\CalculatorServiceInterface::class,
// 服务提供者的服务协议,可选,默认值为 jsonrpc-http
// 可选 jsonrpc-http jsonrpc jsonrpc-tcp-length-check
'protocol' => 'jsonrpc-http',
// 负载均衡算法,可选,默认值为 random
'load_balancer' => 'random',
// 这个消费者要从哪个服务中心获取节点信息,如不配置则不会从服务中心获取节点信息
'registry' => [
'protocol' => 'nacos',
'address' => 'http://172.17.0.1:8849',
],
// 配置项,会影响到 Packer 和 Transporter
]
],
//Nacos 服务驱动相关配置
'drivers' => [
'nacos' => [
'host' => '172.17.0.1',
'port' => 8849,
'username' => 'nacos',
'password' => 'nacos',
],
]
];
到这里消费者的简单代码就完了
五、启动 1.进入hyperf容器
docker exec -it hyperf /bin/bash
2.启动服务端
cd /data/provider
php bin/hyperf.php start
这里当我们启动好了以后就可以去nacos服务中心看到我们的服务了如下图
3.启动客户端
cd /data/consumer
php bin/hyperf.php start
启动完成以后就可以执行调用接口看看微服务是否成功如下图:
小伙伴们!这样就完成了哦! QQ学习交流群:842167453,欢迎小伙伴加入一起学习。