README

dubbo php客户端(以下为中文说明)

Dubbo 是一个分布式服务框架，它通过高性能的RPC远程服务调用能力为应用程序提供服务导入/导出功能。

这只是dubbo php客户端的实现。目前仅支持jsonRPC。
你可以查看我之前写的 dubbo-jsonRPC-demo 示例。

注意

你必须首先启动dubbo和zookeeper，并注册服务提供者。

安装

如果你还没有安装php的 zookeeper扩展，那么

sudo apt-get install php-pear php5-dev make  
sudo pecl install zookeeper

安装zookeeper扩展时可能会出现“zookeeper支持需要libzookeeper”的错误，你应该安装所需的libzookeeper库。

cd ${your zookeeper home dir}/src/c/
./configure
make
sudo make install

将zookeeper.so添加到你的php.ini文件中(/etc/php5/apache2/php.ini和/etc/php5/cli/php.ini)

extension="/usr/lib/php5/20121212/zookeeper.so"  

将dubbo-php-client软件包添加到你的项目中（Composer）

composer require -vvv "quickj/dubbo-php-client:dev-master"

使用方法

use DubboPhp\Client\Client;

$options = [
    'registry_address' => '127.0.0.1:2181',
    'version' => '1.0.0',
    'group' =>null,
    'protocol' => 'jsonrpc'
];

try {
    $dubboCli = new Client($options);
    $testService = $dubboCli->getService("com.dubbo.demo.HelloService");
    $ret = $testService->hello("dubbo php client");
    var_dump($ret);
    $mapRet = $testService->mapEcho();
    var_dump($mapRet);

    $objectRet = $testService->objectEcho();
    var_dump($objectRet);

    /**
     * getService method support 2 way. If the forceVgp = true, It will assign the function parameter to service version,group and protocol. Default way is assign the $options configs to these.
     * getService支持两种方式调用。如果forceVgp=true, 该方法将使用传参来绑定服务的版本号，组和协议。默认方式是使用$options数组里的配置绑定。
     */
    $testServiceWithvgp = $dubboCli->getService("com.dubbo.demo.HelloService","1.0.0",null, $forceVgp = true);
    $vgpRet = $testServiceWithvgp->hello("this request from vgp");
    var_dump($vgpRet);
} catch (\DubboPhp\Client\DubboPhpException $e) {
    print($e->getMessage());
}

dubbo-php-client 中文说明

DUBBO 是一个分布式服务框架，旨在提供高性能和透明化的RPC远程服务调用方案，是阿里巴巴SOA服务化治理方案的核心框架。
这是dubbo的唯一php客户端，目前只支持jsonRPC协议，将来会支持多种协议。你可以查看我之前写的 dubbo-jsonRPC-demo 例子。

注意

在使用之前，你必须安装和启动dubbo，zookeeper，并注册服务提供者。

安装

如果你还没有安装php的 zookeeper扩展，需要

sudo apt-get install php-pear php5-dev make  
sudo pecl install zookeeper

在安装过程中可能会出现“zookeeper支持需要libzookeeper”的错误，说明缺少libzookeeper库，你首先需要安装该库。

cd ${your zookeeper home dir}/src/c/
./configure
make
sudo make install

将zookeeper.so添加到你的php.ini文件中(/etc/php5/apache2/php.ini和/etc/php5/cli/php.ini)
添加以下这行

extension="/usr/lib/php5/20121212/zookeeper.so"

按Composer规范使用dubbo-php-client

composer require -vvv "quickj/dubbo-php-client:dev-master"

调用示例-直接类调用：

use DubboPhp\Client\Client;

$options = [
    'registry_address' => '127.0.0.1:2181',
    'version' => '1.0.0',
    'group' =>null,
    'protocol' => 'jsonrpc'
];

try {
    $dubboCli = new Client($options);
    $testService = $dubboCli->getService("com.dubbo.demo.HelloService");
    $ret = $testService->hello("dubbo php client");
    var_dump($ret);
    $mapRet = $testService->mapEcho();
    var_dump($mapRet);

    $objectRet = $testService->objectEcho();
    var_dump($objectRet);

    /**
     * getService method support 2 way. If the forceVgp = true, It will assign the function parameter to service version,group and protocol. Default way is assign the $options configs to these.
     * getService支持两种方式调用。如果forceVgp=true, 该方法将使用传参来绑定服务的版本号，组和协议。默认方式是使用$options数组里的配置绑定。
     */
    $testServiceWithvgp = $dubboCli->getService("com.dubbo.demo.HelloService","1.0.0",null, $forceVgp = true);
    $vgpRet = $testServiceWithvgp->hello("this request from vgp");
    var_dump($vgpRet);
} catch (\DubboPhp\Client\DubboPhpException $e) {
    print($e->getMessage());
}

Laravel组件模式安装

config/app.php的

providers数组中增加：

DubboPhp\Client\DubboPhpClientServiceProvider::class

aliases别名数组中增加：

'DubboPhpClient'=>DubboPhp\Client\Facades\DubboPhpClient::class,

'DubboPhpClientFactory'=>DubboPhp\Client\Facades\DubboPhpClientFactory::class,

然后命令行发布一下系统基本配置文件dubbo_cli.php到config路径：

php artisan vendor:publish --provider="DubboPhp\Client\DubboPhpClientServiceProvider"

基本安装配置完成，相关的配置在config('dubbo_cli.default')中设置，具体参考配置文件

Laravel中的使用：

单实例方式（配置读取config('dubbo_cli.default')）：

$testService = DubboPhpClient::getService('com.dubbo.demo.HelloService');

$ret = $testService->hello("dubbo php client");
var_dump($ret);
    

多实例的方式（配置读取config('dubbo_cli.connections.xxx')）：

$clientA = DubboPhpClientFactory::factory(config('dubbo_cli.connections.xxxA'));
$testServiceA = $clientA->getService('com.dubbo.demo.HelloService');
$retA = $testServiceA->hello("dubbo php client");
var_dump($retA);

$clientB = DubboPhpClientFactory::factory(config('dubbo_cli.connections.xxxB'));
$testServiceB = $clientB->getService('com.dubbo.demo.HelloService');
$retB = $testServiceB->hello("dubbo php client");
var_dump($retB);