xml|封装
在 php 中本身带有一个用 c 语言实现的 xmlrpc 扩展,叫 xmlrpc-epi。因为它是用 c 语言实现的,所以从速度上来说比用 php 实现的那些 xmlrpc 扩展要快的多。但是在实际应用中却发现很少有人用这个扩展,大都是用 php 脚本实现的 xmlrpc 的扩展。原因可能有以下两点:一是这个扩展需要在服务器上打开,如果没有服务器操作权限,使用这个扩展就不现实了。第二个原因就是这个扩展在 php 手册中的说明太少了,而且提供的函数都很基础,要使用的话就很麻烦了。针对第二个问题,我对这个扩展进行了封装,将它封装成了3个类:xmlrpc_error、xmlrpc_client 和 xmlrpc_server。当然最主要的是后两个类,即 xmlrpc_client 和 xmlrpc_server。这两个类大大简化了创建 xmlrpc 客户端和服务器的步骤。
大家可以通过下面的实例来看一下现在创建 xmlrpc 服务器和客户端的步骤有多么简单。
服务器端代码
下载: server.php
register_method(math.add, add);
$xmlrpc_server->register_method(math.sub, sub);
$xmlrpc_server->register_method(math.mul, mul);
$xmlrpc_server->register_method(math.div, div);
$xmlrpc_server->call_method();
?>
客户端代码
下载: client.php
add($a, $b) . '
';
echo '$a - $b = ' . $xmlrpc_client->sub($a, $b) . '
';
echo '$a * $b = ' . $xmlrpc_client->call('mul', $a, $b) . '
';
echo '$a / $b = ' . $xmlrpc_client->invoke('math.div', $a, $b) . '
';
?>
虽然上面的代码很简单,但是还是有两点需要注意的地方的。
第一,xmlrpc 的方法是支持名空间(namespace)的,为了简化调用——省略方法前面的名空间,我们在初始化 $xmlrpc_client 时,给出了一个名空间的参数“math”,这样下面通过方法名直接调用或者通过call来调用方法时,就可以省略名空间前缀了。如果想要改变名空间,只要给 $xmlrpc_client->namespace 赋值就可以了。如果只是临时改变,也可以通过 invoke 方法来用全名(即带有名空间的方法名)来调用。
第二,xmlrpc 和 php5 的方法是区分大小写的,而 php4 的方法是不区分大小写的,而且在 php4 中,所有的函数或方法名都是储存为小写,因此不论是 add 也好,sub 也好,最后它们所调用的方法都是小写的。所以 php5 中可以直接调用定义中有大写字母的方法,而 php4 中却不能。也就是说,如果想要在 php4 中直接通过方法名来访问 xmlrpc 方法的话,那么必须保证 xmlrpc 的方法名在定义时是小写的,否则就会产生找不到相应方法的错误。如果要在 php4 中调用在定义时就有大写字母的 xmlrpc 方法该怎么办呢?其实很简单,用 call 方法调用就可以了,第一个参数就是要调用的方法名的字符串,这个字符串是可以区分大小写的。也可以用 invoke 方法来调用,不同的地方就是如果有名空间的话,需要明确的写出来。