library phalapi-soap

chenall/phalapi-soap

PhalApi 2.x 扩展类库：利用SOAP搭建Web Services

SOAP

PhalApi SOAP扩展. 当需要使用SOAP时，需要在配置PHP时，通过--enable-soap参数开启SOAP。, _(*1)

安装

在项目下直接运行以下命令即可完成扩展安装。, _(*2)

composer require chenall/phalapi-soap

配置

需要将以下扩展配置添加到项目配置文件./Config/SOAP.php。, _(*3)

return array(
    /**
     * 扩展类库 - SOAP配置
     * @see SoapServer::__construct ( mixed $wsdl [, array $options ] )
     */
    'wsdl' => NULL,
    'options' => array(
        'uri' => 'http://localhost/soap.php',
        'port' => NULL,
    ),
);

其中，wsdl配置对应SoapServer构造函数的第一个参数，options配置则对应第二个参数，其中的uri须与下面的入口文件路径对应。, _(*4)

SOAP服务端访问入口

SOAP扩展不需要注册DI服务，但需要单独实现访问入口，参考以下实现。, _(*5)

// $ vim ./Public/soap.php
/**
 * 统一访问入口
 */
require_once dirname(__FILE__) . '/init.php';

$di = \PhalApi\DI();
$server = new \PhalApi\SOAP\Lite();
$server->response();

至此，SOAP的服务端已搭建完毕。接下来，客户端便可通过SOAP进行访问了。, _(*6)

SOAP客户端调用

SOAP客户端的使用，需要使用SoapClient类，其使用示例如下所示。, _(*7)

$url = 'http://api.phalapi.net/shop/soap.php';
$params = array('servcie' => 'Welcome.Say');

try {
    $client = new SoapClient(null,
        array(
            'location' => $url,
            'uri'      => $url,
        )
    );

    $data = $client->__soapCall('response', array(json_encode($params)));

    //处理返回的数据。。。
    var_dump($data);
}catch(SoapFault $fault){
    echo "Error: ".$fault->faultcode.", string: ".$fault->faultstring;
}

注意，客户端传递的接口参数，最后需要JSON编码后再传递。, _(*8)

(5) SOAP调试脚本

SOAP扩展提供了一个可以发起SOAP访问的脚本，使用示例如下。, _(*9)

$ ./Library/SOAP/check.php http://api.phalapi.net/shop/soap.php "service=Welcome.Say"
array(3) {
  ["ret"]=>
  int(200)
  ["data"]=>
  string(11) "Hello World"
  ["msg"]=>
  string(0) ""
}

(6) 对客户端的影响

当使用SOAP访问接口服务时，服务端可以通过使用SOAP扩展快速搭建Web Services，但对于客户端，如同使用PHPRPC协议一样，也要进行三方面的调整。这里简单说明一下。, _(*10)

• 调用方式的改变

首先是客户端调用方式的改变，需要通过SOAP协议进行访问。, _(*11)

• POST参数传递方式的改变

其次是对POST参数传递的改变。和前面的PHPRPC协议一样，客户端需要把全部的参数JSON编码后再传递。当POST的数据和GET的数据冲突时，以POST为准。, _(*12)

相应地，当需要传递POST参数时，客户需要这样调整：, _(*13)

$data = $client->__soapCall('response', array(json_encode($params)));

若无此POST参数，则可以忽略不传。, _(*14)

• 返回结果格式的改变

和PHPRPC协议一样，客户端接收到的是接口服务直接返回的源数据，不再是序列化后返回的字符串。如前面示例中，返回的是数组类型。, _(*15)