开源地址：https://github.com/flc1125/laravel-hprose
该项目支持 Laravel 及非 Laravel 项目使用，支持 php >= 5.3 版本语法
注： 以下内容，默认你对 Hprose 已经有了一定了解。内容基于 Laravel 项目介绍。
安装
-
环境依赖 C 扩展 hprose，详见：Hprose 官网、Hprose Pecl 扩展
服务端安装即可，客户端可不安装
pecl install hprose
登录后复制 -
安装扩展包
composer require flc/laravel-hprose
登录后复制
配置
服务提供者与门面
Laravel >= 5.5 已增加包自动发现。旧版本，请手动设置
-
在 config/app.php 文件下加入服务提供者
'providers' => [ ... FlcLaravelHproseHproseServiceProvider::class, ]登录后复制 -
在 config/app.php 文件下加入门面
'aliases' => [ ... 'HproseRoute' => FlcLaravelHproseFacadesHproseRoute::class, 'HproseServer' => FlcLaravelHproseFacadesHproseServer::class, 'HproseClient' => FlcLaravelHproseFacadesHproseClient::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' => [
...
appProvidersHproseRouteServiceProvider::class,
]登录后复制
发布配置
php artisan vendor:publish --provider="FlcLaravelHproseHproseServiceProvider"
登录后复制
执行后，会生成配置文件路径：/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-http、tcp、websocket 等，做提前架设
服务端
增加一个 Laravel 路由，用于启动 Http 服务，如：
<?php
Route::any('hprose-server', 'HproseController@server');登录后复制
对应控制器：
<?php
namespace AppHttpControllers;
use HproseServer;
use HproseRoute;
class HproseController
{
public function server()
{
HproseServer::setRouter(HproseRoute::getRouter())->start();
}
}登录后复制
访问：http://localhost/hprose-server
Hprose 路由配置
<?php
HproseRoute::add('tests', 'Controller@tests');
HproseRoute::add('tests_one', 'Controller@tests')->option(['...']);登录后复制
Controller@tests 的方法自行定义
客户端
<?php
namespace AppHttpControllers;
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 FlcLaravelHproseRoutingRouter;
$router->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 FlcLaravelHproseServer($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 FlcLaravelHproseClient($app);
print_r($client->tests->one('222').PHP_EOL);登录后复制
813
收藏
