PHP調用WEBSERVICE接口常見問題答疑以及總結

原創文章，做者：Damon付，如若轉載，請註明出處：《PHP調用WEBSERVICE接口常見問題答疑以及總結》http://www.tiangr.com/php-diao-yong-webservice-jie-kou-chang-jian-wen-ti-da-yi-yi-ji-zong-jie.html

最近的工做項目中，接觸到了不少的政府 [微信開發項目][1]。對方的外包公司都是使用JAVA做爲開發語言，而後經過WEBSERVICE進行接口返回數據到個人項目中。通常狀況下，能在瀏覽器打開並顯示數據的接口是直接可使用 CURL或者file_get_contents進行接收的。可是WEBSERVICE是使用Soapservice。而咱們知道，從php 5以後，php自身已經提供了經過 [SoapClient][2] 調用webservice的方法。使用方法很簡單：

$client = SoapClient('$wsdl'); //也可使用SoapClient('$wsdl', 'UTF-8')設定特定的編碼。
$client->__soapCall($functionName, $params);

調用時可能出現的問題：

1：提示」Class ‘SoapClient’ not found」。

說明沒有安裝php-SOAP服務。在linux下使用
若是是Ubuntu系統，可使用apt-get命令查找soap並安裝。

yum search soap | grep php

安裝完成後，重啓apache服務便可。

**2：沒法傳遞參數，webservice收到的參數均爲null。**

緣由是webservice限制了提交的參數必須爲鍵值對形式，傳遞參數時要用

$params = array( 'key'=>'value', 'key2'=>'value2', 'key3'=>'value3' )

的方式。或者將參數聲明爲一個class，以後使用

$params = array( new class )

進行傳遞。
這時候你確定會困惑，這個'key'值用什麼名稱，這時候，你能夠調用下面的腳本，查看下，全部接口函數的參數須要使用什麼key值。

// to see formated types
$soap = new SoapClient('http://domain.com/ws.php?WSDL');
echo '';
echo 'Types:';
$types = $soap->__getTypes();
foreach ($types as $type) {
    $type = preg_replace( array('/(\w+) ([a-zA-Z0-9]+)/', '/\n /'), array('${1} ${2}', "\n\t"), $type );
    echo $type; echo "\n\n";
}
echo '';

此部分參考http://www.php.net/manual/zh/soapclient.soapcall.php的說明。

3：總結：php有兩個擴展能夠實現web service，一個是NuSoap,一個是php 官方的soap擴展，因爲soap是官方的，因此咱們這裏以soap來實現web service.因爲默認是沒有打開soap擴展的，因此本身先看一下soap擴展有沒有打開。在soap編寫web service的過程當中主要用到了SoapClient,SoapServer,SoapFault三個類。

SoapClient類
這個類用來使用Web services。SoapClient類能夠做爲給定Web services的客戶端。它有兩種操做形式：

* WSDL 模式
* Non-WSDL 模式

在WSDL模式中，構造器可使用WSDL文件名做爲參數，並從WSDL中提取服務所使用的信息。
non-WSDL模式中使用參數來傳遞要使用的信息。

SoapServer類
這個類能夠用來提供Web services。與SoapClient相似，SoapServer也有兩種操做模式：WSDL模式和non-WSDL模式。這兩種模式的意義跟 SoapClient的兩種模式同樣。在WSDL模式中，服務實現了WSDL提供的接口；在non-WSDL模式中，參數被用來管理服務的行爲。

在SoapServer類的衆多方法中，有三個方法比較重要。它們是SoapServer::setClass()，SoapServer::addFunction()和SoapServer::handle()。

下面給出實例：
定義一個提供服務的php類,這個類所提供的函數就是web service對外提供的服務

下面給出服務器端的代碼：

<?php
//下面兩種方式都可以工做，只要指定了相應的uri
//$s = new SoapServer(null,array("uri"=>"Server.php"));
$s = new SoapServer(null,array("location"=>"http://localhost/Test/MyService/Server.php","uri"=>"Server.php"));
$s -> setClass("PersonInfo");
$s -> handle();
?>

下面是客戶端代碼：

<?php
try{
//兩種調用方式，直接調用方法，和用__soapCall簡接調用
$result1 = $soap->getName();
$result2 = $soap->__soapCall("getName",array());
echo $result1."";
echo $result2;
}catch(SoapFault $e){
    echo $e->getMessage();
}catch(Exception $e){
    echo $e->getMessage();
}
?>

參考連接: http://php.net/manual/zh/class.soapclient.php