利用PHP SOAP實現web service

一 什么是SOAP？可以做什么？

SOAP 指簡單對象訪問協議，它是一種基于XML的消息通訊格式，用于網絡上，不同平臺，不同語言的應用程序間的通訊。可自定義，易于擴展。一條 SOAP 消息就是一個普通的 XML 文檔，包含下列元素：
? Envelope 元素，標識XML 文檔一條 SOAP 消息
? Header 元素，包含頭部信息的XML標簽
? Body 元素，包含所有的調用和響應的主體信息的標簽
? Fault 元素，錯誤信息標簽。

?

二 什么是WSDL？可以做什么？

WSDL 指網絡服務描述語言。是一種基于XML編寫的文檔。為用戶提供詳細的接口說明書。

怎樣向別人介紹你的Web服務(Web Service)有哪些功能,以及每個函數調用時的參數呢?你可能會自己寫一套文檔,甚至可能會口頭告訴使用你Web服務的人。

這些非正式的的方法至少都有一個嚴重的問題：當程序員坐到電腦前，想要使用你的Web服務的時候，他們的開放環境無法給他們提供任何幫助，因為這些工具根本不了解你的Web服務.

解決方法是：用機器能閱讀的方式提供一個正式的描述文檔。Web服務描述語言(WSDL)就是這樣一個基于XML的語言。用于描述Web服務及其函數,參數,返回值。因是基于XML，所以WSDL即使機器可閱讀，又是人可閱讀的。

?

三 利用PHP SOAP實例Web Service

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對外提供的服務

Class PersonInfo
{/***    返回姓名*    @return string **/public function getName($name){return "My Name is " . $name;}
}

?

?

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

//包含提供服務的類進來
include 'test.php';
/*創建soap服務端參數1 : wsdl的URL地址,如果不是wsdl模式,傳個NULL參數2 : 如果是wsdl模式,可以不傳.如果不是wsdl模式,傳個數組.定義個uri子單元.*/
$s = new SoapServer(null,array("uri"=>"此處隨便寫,只是命名空間"));//設置用于處理SOAP請求的類
$s -> setClass("PersonInfo");
//處理請求
$s -> handle();

?

?

下面給出客戶端的代碼:

try{//創建soap的客戶端//參數1             wdsl地址//參數2[location]   處理soap請求的地址. //參數2[uri]        命名空間$soap = new SoapClient(null,array('location'=>"http://localhost/test2.php",'uri'=>'hwhwthhsdhg'));//兩種調用方式，直接調用方法，和用__soapCall調用echo $r = $soap->getName('tlijian1989');  }catch(SoapFault $e){echo $e->getMessage();
}catch(Exception $e){echo $e->getMessage();
}

?

?

?