天天看点

PHPRPC安装与使用

我们会首先介绍如何下载与安装 PHPRPC,之后我们会以 PHP、Java 和 JavaScript 三种语言来给出几个简单的示例,让你对 PHPRPC 有一个快速的认识。如果你所使用的语言并不是这三种语言,也没有关系,在你需要的语言章节中同样也会看到类似的简单示例。

下载

你可以直接从本站的下载页中下载到每种语言最新版本的 PHPRPC,也可以通过本站主页上左面的 [Download Lastest Release] 按钮直接下载所有语言的非测试版本的 PHPRPC。

安装

    目前所有版本的 PHPRPC 都是提供源代码的,对于一些脚本语言来说,直接解压缩之后就可以使用了,不需要什么安装步骤。另外一些需要编译的语言,则提供了编译用的 shell 文件(Linux/Unix 下使用)和 bat 文件(Windows 下使用),或者直接提供编译好的二进制库文件。

不过为了让读者能够更清楚如何安装,我们还是对每种语言的安装都做详细的讲解,你可以在安装列表里找到你感兴趣的语言的安装方法。

示例

如果你已经把 PHPRPC 安装好了,那么接下来就让我们开始第一个小程序吧。按照惯例,第一个演示程序几乎总是 HelloWorld,我们也不想打破这个惯例,不过对于 PHPRPC 来说,有服务器端就要有客户端,否则我们就没有什么好演示的啦,所以我们的第一个演示程序实际上是两个,一个是服务器端,另一个是客户端。我们都先用 PHP 语言来写好了。

服务器端

<?php

include ("php/phprpc_server.php");

function HelloWorld() {

    return 'Hello World!';

}

$server = new PHPRPC_Server();

$server->add('HelloWorld');

$server->start();

?>

客户端

view plaincopy to clipboardprint?

<?php

include ("php/phprpc_client.php");

$client = new PHPRPC_Client('http://127.0.0.1/server.php');

echo $client->HelloWorld();

?>

对于服务器端程序,我们应该将它命名为 server.php(这是因为客户端调用时用的是这个名字,而不是 PHPRPC 的什么规定),然后把它放在本地 Web 服务器的根目录下,并保证服务器可以正常运行 PHP 程序,之后在浏览器或命令行下运行客户端程序,你就可以看到结果了。

这两个程序几乎简单到无需解释的地步,所以如果你已经明白它们的意思,那么就可以直接跳过下面的解释,继续看后面的例子。

服务器端第 1 句是将 PHPRPC 的服务器端程序包含到你的程序里,之后的 2 - 4 句是定义一个远程调用的函数,你会发现它与本地函数没有任何区别。第 5 句是创建服务器端对象,第 6 句是添加要发布的方法,这里添加的就是刚刚定义的 HelloWorld 函数,在 PHP 中,添加的发布方法是函数名的字符串表示,在其它语言中可能略有不同。第 7 句是启动服务。

客户端就更简单了,第 1 句是将 PHPRPC 的客户端程序包含到你的程序里。第 2 句是创建客户端对象,其中的参数就是服务器端的地址。第 3 句是对远程方法(函数)的调用,之后通过 echo 将它显示出来。如果顺利的话,执行后你就会看到输出的 Hello World!。

上面的例子是发布的是函数,下面我们来看一下类中的静态方法如何发布:

<?php

include ("php/phprpc_server.php");

class Hello {

    static function HelloWorld() {

        return 'Hello World!';

    }

}

$server = new PHPRPC_Server();

$server->add('HelloWorld', 'Hello');

$server->start();

?>

这个服务器端只要它的名字与发布的地址与上面那个发布函数的例子一样的话,上面的那个客户端就可以得到同样的结果,也就是说,在客户端看来是没有任何区别的。

PHPRPC 并不是只可以在 PHP 中使用,它同样支持其它语言的服务器和客户端,而且还可以无差别的相互调用。

现在我们来看一下如何在 Java 中调用这个 PHP 的服务器方法:

import org.phprpc.*;

interface IHello {

    public String helloWorld();

}

public class HelloWorld {

    public static void main ( String [] args ) {

        PHPRPC_Client client = new PHPRPC_Client("http://127.0.0.1/server.php");

        IHello clientProxy = (IHello)client.useService(IHello.class);

        System.out.println(clientProxy.helloWorld());

    }

}

当我们把这个例子编译之后,在命令行中输入以下命令就可以看到执行结果了:

java -classpath .;phprpc_client.jar HelloWorld

这个 Java 的客户端看上去比 PHP 的要稍微复杂一些,不过仍然很好理解。在 Java 客户端中,我们使用了接口来描述远程方法,之后我们通过 useService 方法返回一个远程代理对象,该对象实现了我们定义的接口,之后我们就可以直接调用远程方法 helloWorld 了。如果你比较细心的话,你还会发现我们在 PHP 中定义的方法和在 Java 中定义的接口的名字的大小写有点不同,但是仍然可以正常调用。是的,PHPRPC 发布的方法是不区分大小写的。所以不论你所使用的语言是否区分大小写,都可以按照自己(或语言)的习惯来定义方法名。

在本章的最后,我们再来看一下在 JavaScript 如何调用 PHPRPC 服务。顺便再强调一下,服务器端不止是可以用 PHP 来编写,你同样可以使用其它语言(比如 Java,.NET,Ruby,Python 等),这里我们只是以 PHP 为例而已。在这个例子中你还会看到如何使用加密传输。

<html>

<head>

    <title>HelloWorld</title>

    <script type="text/javascript" src="phprpc_client.js"></script>

    <script type="text/javascript">

    var client = new PHPRPC_Client('http://127.0.0.1/server.php', ['HelloWorld']);

    client.setEncryptMode(2);

    client.HelloWorld(function (result) {

        alert(result);

    });

    </script>

</head>

<body>

</body>

</html>

这个 JavaScript 是在网页中运行的,这里建议大家要把 head 和 body 标签都写全,即使它们对你来说看上去没有什么用处,但是在有些浏览器中,如果这些标签没有写全,或者写的不正确,程序就不能正确运行。

在这个例子中,我们会发现在创建 PHPRPC_Client 对象时,除了要写服务器地址以外,还要将远程方法的名字作为参数,因为远程方法可能不止一个,所以这个参数是数组类型的。

client.setEncryptMode(2); 这句是设置加密传输,参数 2 表示双向加密,就是参数和结果都加密(只不过这个 HelloWorld 比较特殊,它没有参数)。

接下来就是调用远程方法 HelloWorld 了,我们会发现它跟 PHP 和 Java 客户端的调用不太一样。是的,在 JavaScript 中远程调用都是采用异步方式的,也就是说要获得结果,需要用回调函数,回调函数作为远程方法的最后一个参数,回调函数也有四个参数,这里我们只使用第一个参数,也就是返回结果 result,通过 alert(result); 我们就可以在浏览器中看到最后弹出的 Hello World! 提示框了。

通过上面的例子,我们已经看到在 PHP、Java 和 JavaScript 这三种语言中使用 PHPRPC 都很简单,但因为语言的不同,在写法和用法上又有一些差别。不过你不用担心其它的语言跟它们也会有很大的差别,因为在接下来的章节中你很快就会发现其它语言跟这上面三种语言实现的写法和用法上的相似或相同之处了。