Laravel Hprose RPC 服務

flc1125 發表於 2019-08-09

開源地址:https://github.com/flc1125/laravel-hprose

該專案支援 Laravel 及非 Laravel 專案使用,支援 php >= 5.3 版本語法

注: 以下內容,預設你對 Hprose 已經有了一定了解。內容基於 Laravel 專案介紹。

安裝

服務端安裝即可,客戶端可不安裝

pecl install hprose
  • 安裝擴充套件包
composer require flc/laravel-hprose

配置

服務提供者與門面

Laravel >= 5.5 已增加包自動發現。舊版本,請手動設定

  • config/app.php 檔案下加入服務提供者
'providers' => [

    ...

    Flc\Laravel\Hprose\HproseServiceProvider::class,
]
  • config/app.php 檔案下加入門面
'aliases' => [

    ...

    'HproseRoute' => Flc\Laravel\Hprose\Facades\HproseRoute::class,
    'HproseServer' => Flc\Laravel\Hprose\Facades\HproseServer::class,
    'HproseClient' => Flc\Laravel\Hprose\Facades\HproseClient::class,
]

初始化檔案

php artisan hprose:generator

執行完成後,會分別生成以下檔案:

  • 路由服務提供者:app/Providers/HproseRouteServiceProvider.php
  • 路由檔案:routes/hprose.php (該路由檔案非 Laravel 路由,下文簡稱 Hprose 路由

    Hprose 路由控制器根目錄預設在:app/Http/Controllers/Hprose 目錄下,可自行在 app/Providers/HproseRouteServiceProvider.php 調整

config/app.php 檔案下加入預設的 Hprose 路由服務提供者

'providers' => [

    ...

    app\Providers\HproseRouteServiceProvider::class,
]

釋出配置

php artisan vendor:publish --provider="Flc\Laravel\Hprose\HproseServiceProvider"

執行後,會生成配置檔案路徑:/config/hprose.php

使用

配置說明

配置檔案路徑:/config/hprose.php

<?php

return [
    'server' => [
        'default'     => 'http',
        'connections' => [
            'http' => [
                'protocol' => 'http',
            ],
        ],
    ],

    'client' => [
        'default'     => 'http',
        'connections' => array(
            'http' => array(
                'protocol' => 'http',
                'uri'      => 'http://192.168.2.67:9001/api/server',  // 此處為服務端的連線地址
                'async'    => false,
            ),
        ),
    ]
];

目前版本,除客戶端配置中的遠端伺服器地址外,其他配置預設即可

其他均為後續支援 swoole-httptcpwebsocket 等,做提前架設

服務端

增加一個 Laravel 路由,用於啟動 Http 服務,如:

<?php

Route::any('hprose-server', '[email protected]');

對應控制器:

<?php

namespace App\Http\Controllers;

use HproseServer;
use HproseRoute;

class HproseController
{
    public function server()
    {
        HproseServer::setRouter(HproseRoute::getRouter())->start();
    }
}

訪問:http://localhost/hprose-server

Hprose 路由配置

<?php

HproseRoute::add('tests', '[email protected]');
HproseRoute::add('tests_one', '[email protected]')->option(['...']);

[email protected] 的方法自行定義

客戶端

<?php

namespace App\Http\Controllers;

use HproseClient;

class HproseController
{
    public function client()
    {
        $result = HproseClient::tests('tests');
        $result = HproseClient::connection('other')->tests('tests');  // 其他連線
        $result = HproseClient::connection()->tests->one('tests');

        print_r($result);
    }
}

非 Laravel 專案使用

服務端

<?php

$router = new \Flc\Laravel\Hprose\Routing\Router;
$router->group(['prefix' => 'tests', 'namespace' => 'App\\Controllers'], function ($router) {
    $router->add('one', '[email protected]');
    $router->add('two', '[email protected]')->option(['...']);

    $router->group(['prefix' => 'group'], function ($router) {
        $router->add('one', '[email protected]_one');

        ...

    });
});

$app = [
    'config' => [
        'hprose.server.default' => 'http',
        'hprose.server.connections' => [
            'http' => [
                'protocol' => 'http',
            ],
        ],
    ],
];

$server = new \Flc\Laravel\Hprose\Server($app);
$server->setRouter($router)->start();

客戶端

<?php
$app = [
    'config' => [
        'hprose.client.default' => 'http',
        'hprose.client.connections' => [
            'http' => [
                'protocol' => 'http',
                'uri'      => 'http://localhost/server.php',
                'async'    => false
            ]
        ]
    ]
];

$client = new \Flc\Laravel\Hprose\Client($app);

print_r($client->tests->one('222').PHP_EOL);

捐贈

如果你覺得本擴充套件對你有幫助,請捐贈以表支援,謝謝~~

wechat.jpg

微信

alipay.jpg

支付寶

License

MIT

個人主頁:http://flc.io