Laravel-hprose (rpc 框架)

朱其鹏的个人博客 / 8606 / 18 / 创建于 5年前 / 更新于 5年前

Laravel-hprose

基于 hprose/hprose-php 开发的Laravel扩展：laravel-hprose

版本要求

Laravel>=5.2

安装

composer require "zhuqipeng/laravel-hprose:v1.0-alpha"

或者编辑composer.json

"require": {
    "zhuqipeng/laravel-hprose": "v1.0-alpha"
}

配置

在 config/app.php 注册 ServiceProvider 和 Facade (Laravel 5.5 无需手动注册)

'providers' => [
  // ...

  Zhuqipeng\LaravelHprose\ServiceProvider::class,
]

'aliases' => [
  // ...

  'LaravelHproseMethodManage' => Zhuqipeng\LaravelHprose\Facades\HproseMethodManage::class,
]

配置.env文件

监听地址列表，字符串json格式数组
```
HPROSE_URIS=["tcp://0.0.0.0:1314"]
```
是否启用demo方法，true开启 false关闭，开启后将自动对外发布一个远程调用方法 demo

客户端可调用：$client->demo()
```
HPROSE_DEMO=true // true or false
```
创建配置和路由文件：
```
php artisan vendor:publish --provider="Zhuqipeng\LaravelHprose\ServiceProvider"
```
应用根目录下的config目录下会自动生成新文件hprose.php

应用根目录下的routes目录下会自动生成新文件rpc.php

使用

路由

和 laravel 路由的用法相似，基于 dingo/api 的路由代码上做了简单修改

路由文件

routes/rpc.php

添加路由方法

\LaravelHproseRouter::add(string $name, string|callable $action, array $options = []);

string $name 可供客户端远程调用的方法名
string|callable $action 类方法，格式：App\Controllers\User@update
array $options 是一个关联数组，它里面包含了一些对该服务函数的特殊设置，详情请参考hprose-php官方文档介绍链接

发布远程调用方法 getUserByName 和 userUpdate

\LaravelHproseRouter::add('getUserByName', function ($name) {
    return 'name: ' . $name;
});

\LaravelHproseRouter::add('userUpdate', 'App\Controllers\User@update', ['model' => \Hprose\ResultMode::Normal]);

控制器

<?php

namespace App\Controllers;

class User
{
    public function update($name)
    {
        return 'update name: ' . $name;
    }
}

客户端调用

$client->getUserByName('zhuqipeng');
$client->userUpdate('zhuqipeng');

路由组

\LaravelHproseRouter::group(array $attributes, callable $callback);

array $attributes 属性 ['namespace' => '', 'prefix' => '']
callable $callback 回调函数

\LaravelHproseRouter::group(['namespace' => 'App\Controllers'], function ($route) {
    $route->add('getUserByName', function ($name) {
        return 'name: ' . $name;
    });

    $route->add('userUpdate', 'User@update');
});

客户端调用

$client->getUserByName('zhuqipeng');
$client->userUpdate('zhuqipeng');

前缀

\LaravelHproseRouter::group(['namespace' => 'App\Controllers', 'prefix' => 'user'], function ($route) {
    $route->add('getByName', function ($name) {
        return 'name: ' . $name;
    });

    $route->add('update', 'User@update');
});

客户端调用

$client->user->getByName('zhuqipeng');
$client->user->update('zhuqipeng');
// 或者
$client->user_getByName('zhuqipeng');
$client->user_update('zhuqipeng');