Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/flc1125/laravel-hprose
Laravel Hprose RPC 服务
https://github.com/flc1125/laravel-hprose
Last synced: 17 days ago
JSON representation
Laravel Hprose RPC 服务
- Host: GitHub
- URL: https://github.com/flc1125/laravel-hprose
- Owner: flc1125
- License: mit
- Created: 2019-08-09T08:50:19.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-03-26T09:14:55.000Z (over 4 years ago)
- Last Synced: 2024-11-30T10:43:31.063Z (22 days ago)
- Language: PHP
- Size: 25.4 KB
- Stars: 6
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Laravel-Hprose
该项目支持 Laravel 及非 Laravel 项目使用，支持 `php >= 5.3` 版本语法
> **注：** 以下内容，默认你对 Hprose 已经有了一定了解。内容基于 Laravel 项目介绍。
## 安装
- 环境依赖 C 扩展 `hprose`，详见：[Hprose 官网](https://hprose.com)、[Hprose Pecl 扩展](https://github.com/hprose/hprose-php/wiki/附录B-Hprose-的-pecl-扩展)
> 服务端安装即可，客户端可不安装
```sh
pecl install hprose
```
- 安装扩展包
```sh
composer require flc/laravel-hprose
```
## 配置
### 服务提供者与门面
> `Laravel >= 5.5` 已增加包自动发现。旧版本，请手动设置
- 在 `config/app.php` 文件下加入服务提供者
```php
'providers' => [
...
Flc\Laravel\Hprose\HproseServiceProvider::class,
]
```
- 在 `config/app.php` 文件下加入门面
```php
'aliases' => [
...
'HproseRoute' => Flc\Laravel\Hprose\Facades\HproseRoute::class,
'HproseServer' => Flc\Laravel\Hprose\Facades\HproseServer::class,
'HproseClient' => Flc\Laravel\Hprose\Facades\HproseClient::class,
]
```
### 初始化文件
```sh
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 路由服务提供者
```php
'providers' => [
...
App\Providers\HproseRouteServiceProvider::class,
]
```
## 发布配置
```sh
php artisan vendor:publish --provider="Flc\Laravel\Hprose\HproseServiceProvider"
```
执行后，会生成配置文件路径：`/config/hprose.php`
## 使用
### 配置说明
配置文件路径：`/config/hprose.php`
```php
[
'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-http`、`tcp`、`websocket` 等，做提前架设
### 服务端
增加一个 **Laravel 路由**，用于启动 Http 服务，如：
```php
start();
}
}
```
访问：http://localhost/hprose-server
### Hprose 路由配置
```php
option(['...']);
```
> `Controller@tests` 的方法自行定义
### 客户端
```php
tests('tests'); // 其他连接
$result = HproseClient::connection()->tests->one('tests');
print_r($result);
}
}
```
### 非 Laravel 项目使用
**服务端**
```php
group(['prefix' => 'tests', 'namespace' => 'App\\Controllers'], function ($router) {
$router->add('one', 'Controller@one');
$router->add('two', 'Controller@two')->option(['...']);
$router->group(['prefix' => 'group'], function ($router) {
$router->add('one', 'Controller@group_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
[
'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);
```
## 捐赠
如果你觉得本扩展对你有帮助，请捐赠以表支持，谢谢~~
微信
支付宝
## License
MIT