whereof/laravel-hprose

Hprose RPC 服务 in Laravel/Lumen

1.0.0 2021-12-23 15:41 UTC

This package is auto-updated.

Last update: 2021-12-23 15:41:30 UTC


README

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

Latest Stable Version Total Downloads Latest Unstable Version License PHP Version Require

安装

composer require whereof/laravel-hprose

配置文件

<?php

return [
    //rpc 服务
    'server' => [
        // hprose 调试模式
        'debug' => true,
        //监听地址
        'tcp_uris'       => [
            'tcp://0.0.0.0:1314',
        ],
        //注册rpc 服务 目录地址
        'route_path'     => glob(base_path("rpc") . '/*.php'),
        // 通过路由查看注册的方法
        'http'           => [
            // 如果设置false 在控制台显示调用方法,否在在路由显示调用方法
            'enable'       => false,
            //如果设置了true 这里就是路由前缀
            'route_prefix' => 'rpc'
        ],
    ],
    //rpc 客户端
    'client' => [
        // 服务端监听地址
        'tcp_uris' => [
            'tcp://127.0.0.1:1314',
        ],
        //是否异步
        'async'    => false
    ],
];

日志记录 /config/logging.php

'channels' => [
     ............
     'hprose' => [
      	'driver' => 'daily',
      	'path'   => storage_path('logs/hprose.log'),
      	'days'   => 14,
      ],
]

非强制配置,不配置,就会走默认的日志记录

自定义使用log方法

use \whereof\laravel\hprose\Support\Logger;

laravel配置

//在 `config/app.php` 注册 HproseServiceProvider 
'providers' => [
    .....
    \whereof\laravel\hprose\HproseServiceProvider::class
]
php artisan vendor:publish --provider="whereof\laravel\hprose\HproseServiceProvider"

Lumen配置

将配置信息放在/config/hprose.php
/bootstrap/app.php
$app->register(\whereof\laravel\hprose\HproseServiceProvider::class);
$app->withFacades();

服务端 方法注入,类注入以及目录下类注入 rpc/demo.php

<?php

use whereof\laravel\hprose\Facades\HproseRoute;
// 注册callback
HproseRoute::add(function () {
    return 'service hello';
}, 'hello');
// 注册class
HproseRoute::add(\whereof\laravel\hprose\Services\UserServer::class);

//注册中间价
HproseRoute::addInvokeHandler(function ($name, array &$args, stdClass $context, Closure $next) {
    $result = $next($name, $args, $context);
    return $result;
});
// 注册整个目录
HproseRoute::addPath(app_path('Services'));

使用addPath的时候要注意:在类中构造方法__construct 参数不能是必传参数.

忽略注解

可以忽略类中的某个方法不被进行hprose远程调用,也可以忽略某个类不被远程调用

唯一标识 ignoreHprose

方法忽略

/**
* 注解方式忽略类中的方法
* @return string
* @ignoreHprose
*/
public function index()
{
	return '用户列表';
}

类忽略

/**
 * Class UserServer.
 * @ignoreHprose
 */
class UserServer

启动rpc服务

php artisan hprose:socket

客户端调用

$uris   = ['tcp://127.0.0.1:1314'];
$client = new \whereof\laravel\hprose\Clients\SocketClient($uris, false);
$client->hello();

$client->whereof_laravel_hprose_services_userserver->index();
或
$client->whereof->laravel->hprose->services->userserver->index();
需要配置配置
'client' => [
  'tcp_uris' => [
  	'tcp://127.0.0.1:1314',
  ],
  'async' => false
],
app('hprose.socket.client')->hello();

app('hprose.socket.client')->whereof_laravel_hprose_services_userserver->index();
或
app('hprose.socket.client')->whereof->laravel->hprose->services->userserver->index();

加入我们

如果你认可我们的开源项目,有兴趣为 laravel-hprose 的发展做贡献,竭诚欢迎加入我们一起开发完善。无论是报告错误或是 Pull Request 开发,那怕是修改一个错别字也是对我们莫大的帮助。

关于我

https://github.com/whereof/whereof

许可协议

MIT