laravel-hprose(rpc框架)

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"
}

配置

1. 在 config/app.php 註冊 ServiceProvider 和 Facade (Laravel 5.5 無需手動註冊)

   'providers' => [
     // ...
   
     Zhuqipeng\LaravelHprose\ServiceProvider::class,
   ]

   'aliases' => [
     // ...
   
     'LaravelHproseMethodManage' => Zhuqipeng\LaravelHprose\Facades\HproseMethodManage::class,
   ]

2. 配置.env文件

   監聽地址列表，字符串json格式數組

   HPROSE_URIS=["tcp://0.0.0.0:1314"]

   是否啓用demo方法，true開啓 false關閉，開啓後將自動對外發佈一個遠程調用方法 demo

   客戶端可調用：$client->demo()

   HPROSE_DEMO=true // true or false

3. 建立配置和路由文件：

   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 類方法，格式：AppControllersUser@update
• array $options 是一個關聯數組，它裏面包含了一些對該服務函數的特殊設置，詳情請參考hprose-php官方文檔介紹 連接

發佈遠程調用方法 getUserByName 和 update

\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');

啓動服務

php artisan hprose:socket_server