SOAP
- はじめに
- インストール/設定
- 定義済み定数
- SOAP 関数
- is_soap_fault — SOAP コールが失敗したかどうかを調べる
- use_soap_error_handler — SOAP エラーハンドラを使用するかどうかを設定する
- SoapClient — SoapClient クラス
- SoapClient::__call — SOAP 関数をコールする (非推奨)
- SoapClient::__construct — SoapClient のコンストラクタ
- SoapClient::__doRequest — SOAP リクエストを実行する
- SoapClient::__getCookies — クッキーの一覧を取得する
- SoapClient::__getFunctions — SOAP 関数の一覧を返す
- SoapClient::__getLastRequest — 直近の SOAP リクエストを返す
- SoapClient::__getLastRequestHeaders — 直近の SOAP リクエストヘッダを返す
- SoapClient::__getLastResponse — 直近の SOAP レスポンスを返す
- SoapClient::__getLastResponseHeaders — 直近の SOAP レスポンスヘッダを返す
- SoapClient::__getTypes — SOAP 型の一覧を返す
- SoapClient::__setCookie — SOAP リクエストと共に送信されるクッキーを設定する
- SoapClient::__setLocation — 使用するウェブサービスの場所を設定する
- SoapClient::__setSoapHeaders — 以降のコール用の SOAP ヘッダを設定する
- SoapClient::__soapCall — SOAP 関数をコールする
- SoapServer — SoapServer クラス
- SoapServer::addFunction — SOAP リクエストによって処理される単一もしくはいくつかの関数を追加する
- SoapServer::addSoapHeader — SOAP ヘッダをレスポンスに追加する
- SoapServer::__construct — SoapServer コンストラクタ
- SoapServer::fault — エラーを示す SoapServer フォールト を発行する
- SoapServer::getFunctions — 定義されている関数の一覧を返す
- SoapServer::__getLastResponse — 最新のSOAPレスポンスを返す
- SoapServer::handle — SOAP リクエストを処理する
- SoapServer::setClass — SOAP リクエストを処理するクラスを設定する
- SoapServer::setObject — SOAP リクエストの処理に使用するオブジェクトを設定する
- SoapServer::setPersistence — SoapServer の持続モードを設定する
- SoapFault — SoapFault クラス
- SoapFault::__construct — SoapFault コンストラクタ
- SoapFault::__toString — SoapFault の文字列表現を取得する
- SoapHeader — SoapHeader クラス
- SoapHeader::__construct — SoapHeader コンストラクタ
- SoapParam — SoapParam クラス
- SoapParam::__construct — SoapParam コンストラクタ
- SoapVar — SoapVar クラス
- SoapVar::__construct — SoapVar コンストラクタ
+add a note
User Contributed Notes 7 notes
nodkz at mail dot ru ¶
16 years ago
PROBLEM (with SOAP extension under PHP5) of transferring object, that contains objects or array of objects. Nested object would not transfer.
SOLUTION:
This class was developed by trial and error by me. So this 23 lines of code for most developers writing under PHP5 solves fate of using SOAP extension.
<?php
/*
According to specific of organization process of SOAP class in PHP5, we must wrap up complex objects in SoapVar class. Otherwise objects would not be encoded properly and could not be loaded on remote SOAP handler.
Function "getAsSoap" call for encoding object for transmission. After encoding it can be properly transmitted.
*/
abstract class SOAPable {
public function getAsSOAP() {
foreach($this as $key=>&$value) {
$this->prepareSOAPrecursive($this->$key);
}
return $this;
}
private function prepareSOAPrecursive(&$element) {
if(is_array($element)) {
foreach($element as $key=>&$val) {
$this->prepareSOAPrecursive($val);
}
$element=new SoapVar($element,SOAP_ENC_ARRAY);
}elseif(is_object($element)) {
if($element instanceof SOAPable) {
$element->getAsSOAP();
}
$element=new SoapVar($element,SOAP_ENC_OBJECT);
}
}
}
// ------------------------------------------
// ABSTRACT EXAMPLE
// ------------------------------------------
class PersonList extends SOAPable {
protected $ArrayOfPerson; // variable MUST be protected or public!
}
class Person extends SOAPable {
//any data
}
$client=new SoapClient("test.wsdl", array( 'soap_version'=>SOAP_1_2, 'trace'=>1, 'classmap' => array('Person' => "Person", 'PersonList' => "PersonList") ));
$PersonList=new PersonList;
// some actions
$PersonList->getAsSOAP();
$client->someMethod($PersonList);
?>
So every class, which will transfer via SOAP, must be extends from class SOAPable.
As you can see, in code above, function prepareSOAPrecursive search another nested objects in parent object or in arrays, and if does it, tries call function getAsSOAP() for preparation of nested objects, after that simply wrap up via SoapVar class.
So in code before transmitting simply call $obj->getAsSOAP()
Ryan ¶
16 years ago
If you are having an issue where SOAP cannot find the functions that are actually there if you view the wsdl file, it's because PHP is caching the wsdl file (for a day at a time). To turn this off, have this line on every script that uses SOAP: ini_set("soap.wsdl_cache_enabled", "0"); to disable the caching feature.
Raphal Gertz ¶
15 years ago
Juste a note to avoid wasting time on php-soap protocol and format support.
Until php 5.2.9 (at least) the soap extension is only capable of understanding wsdl 1.0 and 1.1 format.
The wsdl 2.0, a W3C recommendation since june 2007, ISN'T supported in php soap extension.
(the soap/php_sdl.c source code don't handle wsdl2.0 format)
The wsdl 2.0 is juste the 1.2 version renamed because it has substantial differences from WSDL 1.1.
The differences between the two format may not be invisible if you don't care a lot.
The wsdl 1.0 format structure (see http://www.w3.org/TR/wsdl) :
<definitions ...>
<types ...>
</types>
<message ...>
<part ...>
</message>
<portType ...>
<operation ...>
<input ... />
<output ... />
<fault ... />
</operation>
</portType>
<binding ...>
<operation ...>
<input ... />
<output ... />
<fault ... />
</operation>
</binding>
<service ...>
<port ...>
</service>
</definitions>
And the wsdl 2.0 format structure (see http://www.w3.org/TR/wsdl20/) :
<description ...>
<types ...>
</types>
<interface ...>
<fault ... />
<operation ...>
<input ... />
<output ... />
<fault ... />
</operation>
</interface>
<binding ...>
<fault ... />
<operation ...>
<input ... />
<output ... />
<fault ... />
</operation>
</binding>
<service ...>
<endpoint ...>
</service>
</description>
The typical error message if you provide a wsdl 2.0 format file :
PHP Fatal error: SOAP-ERROR: Parsing WSDL: Couldn't find <definitions> in 'wsdl/example.wsdl' in /path/client.php on line 9
Luke ¶
9 years ago
Was calling an asmx method like $success=$x->AuthenticateUser($userName,$password) and this was returning me an error.
However i changed it and added the userName and password in an array and its now KAWA...
moazzam at moazzam-khan dot com ¶
15 years ago
If anyone is trying to use this for accessing Sabre's web services, it won't work. Sabre checks the request header "Content-Type" to see if it is "text/xml" . If it is not text/xml then it sends an error back.
You will need to create a socket connection and use that to send the request over.
stephenlansell at gmail dot com ¶
14 years ago
Here is an example of a php client talking to a asmx server:
<?php
$soapClient = new SoapClient("https://soapserver.example.com/blahblah.asmx?wsdl");
// Prepare SoapHeader parameters
$sh_param = array(
'Username' => 'username',
'Password' => 'password');
$headers = new SoapHeader('http://soapserver.example.com/webservices', 'UserCredentials', $sh_param);
// Prepare Soap Client
$soapClient->__setSoapHeaders(array($headers));
// Setup the RemoteFunction parameters
$ap_param = array(
'amount' => $irow['total_price']);
// Call RemoteFunction ()
$error = 0;
try {
$info = $soapClient->__call("RemoteFunction", array($ap_param));
} catch (SoapFault $fault) {
$error = 1;
print("
alert('Sorry, blah returned the following ERROR: ".$fault->faultcode."-".$fault->faultstring.". We will now take you back to our home page.');
window.location = 'main.php';
");
}
if ($error == 0) {
$auth_num = $info->RemoteFunctionResult;
if ($auth_num < 0) {
....
// Setup the OtherRemoteFunction() parameters
$at_param = array(
'amount' => $irow['total_price'],
'description' => $description);
// Call OtherRemoteFunction()
$trans = $soapClient->__call("OtherRemoteFunction", array($at_param));
$trans_result = $trans->OtherRemoteFunctionResult;
....
} else {
// Record the transaction error in the database
// Kill the link to Soap
unset($soapClient);
}
}
}
}
?>
rafinskipg at gmail dot com ¶
12 years ago
Support for MTOM addign this code to your project:
<?php
class MySoapClient extends SoapClient
{
public function __doRequest($request, $location, $action, $version, $one_way = 0)
{
$response = parent::__doRequest($request, $location, $action, $version, $one_way);
// parse $response, extract the multipart messages and so on
//this part removes stuff
$start=strpos($response,'<?xml');
$end=strrpos($response,'>');
$response_string=substr($response,$start,$end-$start+1);
return($response_string);
}
}
?>
Then you can do this
<?php
new MySoapClient($wsdl_url);
?>
↑ and ↓ to navigate •
Enter to select •
Esc to close
Press Enter without
selection to search using Google