class nusoapclient in Salesforce Suite 5
Same name and namespace in other branches
- 5.2 includes/nusoap.php \nusoapclient
nusoapclient higher level class for easy usage.
usage:
// instantiate client with server info $nusoapclient = new nusoapclient( string path [ ,boolean wsdl] );
// call method, get results echo $nusoapclient->call( string methodname [ ,array parameters] );
// bye bye client unset($nusoapclient);
@author Dietrich Ayala <dietrich@ganx4.com> @access public
Hierarchy
- class \nusoapclient extends \nusoap_base
Expanded class hierarchy of nusoapclient
File
- includes/
nusoap.php, line 6434
View source
class nusoapclient extends nusoap_base {
var $username = '';
var $password = '';
var $authtype = '';
var $certRequest = [];
var $requestHeaders = false;
// SOAP headers in request (text)
var $responseHeaders = '';
// SOAP headers from response (incomplete namespace resolution) (text)
var $document = '';
// SOAP body response portion (incomplete namespace resolution) (text)
var $endpoint;
var $forceEndpoint = '';
// overrides WSDL endpoint
var $proxyhost = '';
var $proxyport = '';
var $proxyusername = '';
var $proxypassword = '';
var $xml_encoding = '';
// character set encoding of incoming (response) messages
var $http_encoding = false;
var $timeout = 0;
// HTTP connection timeout
var $response_timeout = 30;
// HTTP response timeout
var $endpointType = '';
// soap|wsdl, empty for WSDL initialization error
var $persistentConnection = false;
var $defaultRpcParams = false;
// This is no longer used
var $request = '';
// HTTP request
var $response = '';
// HTTP response
var $responseData = '';
// SOAP payload of response
var $cookies = [];
// Cookies from response or for request
var $decode_utf8 = true;
// toggles whether the parser decodes element content w/ utf8_decode()
var $operations = [];
// WSDL operations, empty for WSDL initialization error
/*
* fault related variables
*/
/**
* @var fault
* @access public
*/
var $fault;
/**
* @var faultcode
* @access public
*/
var $faultcode;
/**
* @var faultstring
* @access public
*/
var $faultstring;
/**
* @var faultdetail
* @access public
*/
var $faultdetail;
/**
* constructor
*
* @param mixed $endpoint SOAP server or WSDL URL (string), or wsdl instance (object)
* @param bool $wsdl optional, set to true if using WSDL
* @param int $portName optional portName in WSDL document
* @param string $proxyhost
* @param string $proxyport
* @param string $proxyusername
* @param string $proxypassword
* @param integer $timeout set the connection timeout
* @param integer $response_timeout set the response timeout
* @access public
*/
function nusoapclient($endpoint, $wsdl = false, $proxyhost = false, $proxyport = false, $proxyusername = false, $proxypassword = false, $timeout = 0, $response_timeout = 30) {
parent::nusoap_base();
$this->endpoint = $endpoint;
$this->proxyhost = $proxyhost;
$this->proxyport = $proxyport;
$this->proxyusername = $proxyusername;
$this->proxypassword = $proxypassword;
$this->timeout = $timeout;
$this->response_timeout = $response_timeout;
// make values
if ($wsdl) {
if (is_object($endpoint) && get_class($endpoint) == 'wsdl') {
$this->wsdl = $endpoint;
$this->endpoint = $this->wsdl->wsdl;
$this->wsdlFile = $this->endpoint;
$this
->debug('existing wsdl instance created from ' . $this->endpoint);
}
else {
$this->wsdlFile = $this->endpoint;
// instantiate wsdl object and parse wsdl file
$this
->debug('instantiating wsdl class with doc: ' . $endpoint);
$this->wsdl =& new wsdl($this->wsdlFile, $this->proxyhost, $this->proxyport, $this->proxyusername, $this->proxypassword, $this->timeout, $this->response_timeout);
}
$this
->appendDebug($this->wsdl
->getDebug());
$this->wsdl
->clearDebug();
// catch errors
if ($errstr = $this->wsdl
->getError()) {
$this
->debug('got wsdl error: ' . $errstr);
$this
->setError('wsdl error: ' . $errstr);
}
elseif ($this->operations = $this->wsdl
->getOperations()) {
$this
->debug('got ' . count($this->operations) . ' operations from wsdl ' . $this->wsdlFile);
$this->endpointType = 'wsdl';
}
else {
$this
->debug('getOperations returned false');
$this
->setError('no operations defined in the WSDL document!');
}
}
else {
$this
->debug("instantiate SOAP with endpoint at {$endpoint}");
$this->endpointType = 'soap';
}
}
/**
* calls method, returns PHP native type
*
* @param string $method SOAP server URL or path
* @param mixed $params An array, associative or simple, of the parameters
* for the method call, or a string that is the XML
* for the call. For rpc style, this call will
* wrap the XML in a tag named after the method, as
* well as the SOAP Envelope and Body. For document
* style, this will only wrap with the Envelope and Body.
* IMPORTANT: when using an array with document style,
* in which case there
* is really one parameter, the root of the fragment
* used in the call, which encloses what programmers
* normally think of parameters. A parameter array
* *must* include the wrapper.
* @param string $namespace optional method namespace (WSDL can override)
* @param string $soapAction optional SOAPAction value (WSDL can override)
* @param mixed $headers optional string of XML with SOAP header content, or array of soapval objects for SOAP headers
* @param boolean $rpcParams optional (no longer used)
* @param string $style optional (rpc|document) the style to use when serializing parameters (WSDL can override)
* @param string $use optional (encoded|literal) the use when serializing parameters (WSDL can override)
* @return mixed response from SOAP call
* @access public
*/
function call($operation, $params = [], $namespace = 'http://tempuri.org', $soapAction = '', $headers = false, $rpcParams = null, $style = 'rpc', $use = 'encoded') {
$this->operation = $operation;
$this->fault = false;
$this
->setError('');
$this->request = '';
$this->response = '';
$this->responseData = '';
$this->faultstring = '';
$this->faultcode = '';
$this->opData = array();
$this
->debug("call: operation={$operation}, namespace={$namespace}, soapAction={$soapAction}, rpcParams={$rpcParams}, style={$style}, use={$use}, endpointType={$this->endpointType}");
$this
->appendDebug('params=' . $this
->varDump($params));
$this
->appendDebug('headers=' . $this
->varDump($headers));
if ($headers) {
$this->requestHeaders = $headers;
}
// serialize parameters
if ($this->endpointType == 'wsdl' && ($opData = $this
->getOperationData($operation))) {
// use WSDL for operation
$this->opData = $opData;
$this
->debug("found operation");
$this
->appendDebug('opData=' . $this
->varDump($opData));
if (isset($opData['soapAction'])) {
$soapAction = $opData['soapAction'];
}
if (!$this->forceEndpoint) {
$this->endpoint = $opData['endpoint'];
}
else {
$this->endpoint = $this->forceEndpoint;
}
$namespace = isset($opData['input']['namespace']) ? $opData['input']['namespace'] : $namespace;
$style = $opData['style'];
$use = $opData['input']['use'];
// add ns to ns array
if ($namespace != '' && !isset($this->wsdl->namespaces[$namespace])) {
$nsPrefix = 'ns' . rand(1000, 9999);
$this->wsdl->namespaces[$nsPrefix] = $namespace;
}
$nsPrefix = $this->wsdl
->getPrefixFromNamespace($namespace);
// serialize payload
if (is_string($params)) {
$this
->debug("serializing param string for WSDL operation {$operation}");
$payload = $params;
}
elseif (is_array($params)) {
$this
->debug("serializing param array for WSDL operation {$operation}");
$payload = $this->wsdl
->serializeRPCParameters($operation, 'input', $params);
}
else {
$this
->debug('params must be array or string');
$this
->setError('params must be array or string');
return false;
}
$usedNamespaces = $this->wsdl->usedNamespaces;
if (isset($opData['input']['encodingStyle'])) {
$encodingStyle = $opData['input']['encodingStyle'];
}
else {
$encodingStyle = '';
}
$this
->appendDebug($this->wsdl
->getDebug());
$this->wsdl
->clearDebug();
if ($errstr = $this->wsdl
->getError()) {
$this
->debug('got wsdl error: ' . $errstr);
$this
->setError('wsdl error: ' . $errstr);
return false;
}
}
elseif ($this->endpointType == 'wsdl') {
// operation not in WSDL
$this
->appendDebug($this->wsdl
->getDebug());
$this->wsdl
->clearDebug();
$this
->setError('operation ' . $operation . ' not present.');
$this
->debug("operation '{$operation}' not present.");
return false;
}
else {
// no WSDL
//$this->namespaces['ns1'] = $namespace;
$nsPrefix = 'ns' . rand(1000, 9999);
// serialize
$payload = '';
if (is_string($params)) {
$this
->debug("serializing param string for operation {$operation}");
$payload = $params;
}
elseif (is_array($params)) {
$this
->debug("serializing param array for operation {$operation}");
foreach ($params as $k => $v) {
$payload .= $this
->serialize_val($v, $k, false, false, false, false, $use);
}
}
else {
$this
->debug('params must be array or string');
$this
->setError('params must be array or string');
return false;
}
$usedNamespaces = array();
if ($use == 'encoded') {
$encodingStyle = 'http://schemas.xmlsoap.org/soap/encoding/';
}
else {
$encodingStyle = '';
}
}
// wrap RPC calls with method element
if ($style == 'rpc') {
if ($use == 'literal') {
$this
->debug("wrapping RPC request with literal method element");
if ($namespace) {
$payload = "<{$operation} xmlns=\"{$namespace}\">" . $payload . "</{$operation}>";
}
else {
$payload = "<{$operation}>" . $payload . "</{$operation}>";
}
}
else {
$this
->debug("wrapping RPC request with encoded method element");
if ($namespace) {
$payload = "<{$nsPrefix}:{$operation} xmlns:{$nsPrefix}=\"{$namespace}\">" . $payload . "</{$nsPrefix}:{$operation}>";
}
else {
$payload = "<{$operation}>" . $payload . "</{$operation}>";
}
}
}
// serialize envelope
$soapmsg = $this
->serializeEnvelope($payload, $this->requestHeaders, $usedNamespaces, $style, $use, $encodingStyle);
$this
->debug("endpoint={$this->endpoint}, soapAction={$soapAction}, namespace={$namespace}, style={$style}, use={$use}, encodingStyle={$encodingStyle}");
$this
->debug('SOAP message length=' . strlen($soapmsg) . ' contents (max 1000 bytes)=' . substr($soapmsg, 0, 1000));
// send
$return = $this
->send($this
->getHTTPBody($soapmsg), $soapAction, $this->timeout, $this->response_timeout);
if ($errstr = $this
->getError()) {
$this
->debug('Error: ' . $errstr);
return false;
}
else {
$this->return = $return;
$this
->debug('sent message successfully and got a(n) ' . gettype($return));
$this
->appendDebug('return=' . $this
->varDump($return));
// fault?
if (is_array($return) && isset($return['faultcode'])) {
$this
->debug('got fault');
$this
->setError($return['faultcode'] . ': ' . $return['faultstring']);
$this->fault = true;
foreach ($return as $k => $v) {
$this->{$k} = $v;
$this
->debug("{$k} = {$v}<br>");
}
return $return;
}
elseif ($style == 'document') {
// NOTE: if the response is defined to have multiple parts (i.e. unwrapped),
// we are only going to return the first part here...sorry about that
return $return;
}
else {
// array of return values
if (is_array($return)) {
// multiple 'out' parameters, which we return wrapped up
// in the array
if (sizeof($return) > 1) {
return $return;
}
// single 'out' parameter (normally the return value)
$return = array_shift($return);
$this
->debug('return shifted value: ');
$this
->appendDebug($this
->varDump($return));
return $return;
// nothing returned (ie, echoVoid)
}
else {
return "";
}
}
}
}
/**
* get available data pertaining to an operation
*
* @param string $operation operation name
* @return array array of data pertaining to the operation
* @access public
*/
function getOperationData($operation) {
if (isset($this->operations[$operation])) {
return $this->operations[$operation];
}
$this
->debug("No data for operation: {$operation}");
}
/**
* send the SOAP message
*
* Note: if the operation has multiple return values
* the return value of this method will be an array
* of those values.
*
* @param string $msg a SOAPx4 soapmsg object
* @param string $soapaction SOAPAction value
* @param integer $timeout set connection timeout in seconds
* @param integer $response_timeout set response timeout in seconds
* @return mixed native PHP types.
* @access private
*/
function send($msg, $soapaction = '', $timeout = 0, $response_timeout = 30) {
$this
->checkCookies();
// detect transport
switch (true) {
// http(s)
case ereg('^http', $this->endpoint):
$this
->debug('transporting via HTTP');
if ($this->persistentConnection == true && is_object($this->persistentConnection)) {
$http =& $this->persistentConnection;
}
else {
$http = new soap_transport_http($this->endpoint);
if ($this->persistentConnection) {
$http
->usePersistentConnection();
}
}
$http
->setContentType($this
->getHTTPContentType(), $this
->getHTTPContentTypeCharset());
$http
->setSOAPAction($soapaction);
if ($this->proxyhost && $this->proxyport) {
$http
->setProxy($this->proxyhost, $this->proxyport, $this->proxyusername, $this->proxypassword);
}
if ($this->authtype != '') {
$http
->setCredentials($this->username, $this->password, $this->authtype, array(), $this->certRequest);
}
if ($this->http_encoding != '') {
$http
->setEncoding($this->http_encoding);
}
$this
->debug('sending message, length=' . strlen($msg));
if (ereg('^http:', $this->endpoint)) {
//if(strpos($this->endpoint,'http:')){
$this->responseData = $http
->send($msg, $timeout, $response_timeout, $this->cookies);
}
elseif (ereg('^https', $this->endpoint)) {
//} elseif(strpos($this->endpoint,'https:')){
//if(phpversion() == '4.3.0-dev'){
//$response = $http->send($msg,$timeout,$response_timeout);
//$this->request = $http->outgoing_payload;
//$this->response = $http->incoming_payload;
//} else
$this->responseData = $http
->sendHTTPS($msg, $timeout, $response_timeout, $this->cookies);
}
else {
$this
->setError('no http/s in endpoint url');
}
$this->request = $http->outgoing_payload;
$this->response = $http->incoming_payload;
$this
->appendDebug($http
->getDebug());
$this
->UpdateCookies($http->incoming_cookies);
// save transport object if using persistent connections
if ($this->persistentConnection) {
$http
->clearDebug();
if (!is_object($this->persistentConnection)) {
$this->persistentConnection = $http;
}
}
if ($err = $http
->getError()) {
$this
->setError('HTTP Error: ' . $err);
return false;
}
elseif ($this
->getError()) {
return false;
}
else {
$this
->debug('got response, length=' . strlen($this->responseData) . ' type=' . $http->incoming_headers['content-type']);
return $this
->parseResponse($http->incoming_headers, $this->responseData);
}
break;
default:
$this
->setError('no transport found, or selected transport is not yet supported!');
return false;
break;
}
}
/**
* processes SOAP message returned from server
*
* @param array $headers The HTTP headers
* @param string $data unprocessed response data from server
* @return mixed value of the message, decoded into a PHP type
* @access private
*/
function parseResponse($headers, $data) {
$this
->debug('Entering parseResponse() for data of length ' . strlen($data) . ' and type ' . $headers['content-type']);
if (!strstr($headers['content-type'], 'text/xml')) {
$this
->setError('Response not of type text/xml');
return false;
}
if (strpos($headers['content-type'], '=')) {
$enc = str_replace('"', '', substr(strstr($headers["content-type"], '='), 1));
$this
->debug('Got response encoding: ' . $enc);
if (eregi('^(ISO-8859-1|US-ASCII|UTF-8)$', $enc)) {
$this->xml_encoding = strtoupper($enc);
}
else {
$this->xml_encoding = 'US-ASCII';
}
}
else {
// should be US-ASCII for HTTP 1.0 or ISO-8859-1 for HTTP 1.1
$this->xml_encoding = 'ISO-8859-1';
}
$this
->debug('Use encoding: ' . $this->xml_encoding . ' when creating soap_parser');
$parser = new soap_parser($data, $this->xml_encoding, $this->operation, $this->decode_utf8);
// add parser debug data to our debug
$this
->appendDebug($parser
->getDebug());
// if parse errors
if ($errstr = $parser
->getError()) {
$this
->setError($errstr);
// destroy the parser object
unset($parser);
return false;
}
else {
// get SOAP headers
$this->responseHeaders = $parser
->getHeaders();
// get decoded message
$return = $parser
->get_response();
// add document for doclit support
$this->document = $parser->document;
// destroy the parser object
unset($parser);
// return decode message
return $return;
}
}
/**
* sets the SOAP endpoint, which can override WSDL
*
* @param $endpoint string The endpoint URL to use, or empty string or false to prevent override
* @access public
*/
function setEndpoint($endpoint) {
$this->forceEndpoint = $endpoint;
}
/**
* set the SOAP headers
*
* @param $headers mixed String of XML with SOAP header content, or array of soapval objects for SOAP headers
* @access public
*/
function setHeaders($headers) {
$this->requestHeaders = $headers;
}
/**
* get the SOAP response headers (namespace resolution incomplete)
*
* @return string
* @access public
*/
function getHeaders() {
return $this->responseHeaders;
}
/**
* set proxy info here
*
* @param string $proxyhost
* @param string $proxyport
* @param string $proxyusername
* @param string $proxypassword
* @access public
*/
function setHTTPProxy($proxyhost, $proxyport, $proxyusername = '', $proxypassword = '') {
$this->proxyhost = $proxyhost;
$this->proxyport = $proxyport;
$this->proxyusername = $proxyusername;
$this->proxypassword = $proxypassword;
}
/**
* if authenticating, set user credentials here
*
* @param string $username
* @param string $password
* @param string $authtype (basic|digest|certificate)
* @param array $certRequest (keys must be cainfofile (optional), sslcertfile, sslkeyfile, passphrase, verifypeer (optional), verifyhost (optional): see corresponding options in cURL docs)
* @access public
*/
function setCredentials($username, $password, $authtype = 'basic', $certRequest = []) {
$this->username = $username;
$this->password = $password;
$this->authtype = $authtype;
$this->certRequest = $certRequest;
}
/**
* use HTTP encoding
*
* @param string $enc
* @access public
*/
function setHTTPEncoding($enc = 'gzip, deflate') {
$this->http_encoding = $enc;
}
/**
* use HTTP persistent connections if possible
*
* @access public
*/
function useHTTPPersistentConnection() {
$this->persistentConnection = true;
}
/**
* gets the default RPC parameter setting.
* If true, default is that call params are like RPC even for document style.
* Each call() can override this value.
*
* This is no longer used.
*
* @return boolean
* @access public
* @deprecated
*/
function getDefaultRpcParams() {
return $this->defaultRpcParams;
}
/**
* sets the default RPC parameter setting.
* If true, default is that call params are like RPC even for document style
* Each call() can override this value.
*
* This is no longer used.
*
* @param boolean $rpcParams
* @access public
* @deprecated
*/
function setDefaultRpcParams($rpcParams) {
$this->defaultRpcParams = $rpcParams;
}
/**
* dynamically creates an instance of a proxy class,
* allowing user to directly call methods from wsdl
*
* @return object soap_proxy object
* @access public
*/
function getProxy() {
$r = rand();
$evalStr = $this
->_getProxyClassCode($r);
//$this->debug("proxy class: $evalStr";
// eval the class
eval($evalStr);
// instantiate proxy object
eval("\$proxy = new soap_proxy_{$r}('');");
// transfer current wsdl data to the proxy thereby avoiding parsing the wsdl twice
$proxy->endpointType = 'wsdl';
$proxy->wsdlFile = $this->wsdlFile;
$proxy->wsdl = $this->wsdl;
$proxy->operations = $this->operations;
$proxy->defaultRpcParams = $this->defaultRpcParams;
// transfer other state
$proxy->username = $this->username;
$proxy->password = $this->password;
$proxy->authtype = $this->authtype;
$proxy->proxyhost = $this->proxyhost;
$proxy->proxyport = $this->proxyport;
$proxy->proxyusername = $this->proxyusername;
$proxy->proxypassword = $this->proxypassword;
$proxy->timeout = $this->timeout;
$proxy->response_timeout = $this->response_timeout;
$proxy->http_encoding = $this->http_encoding;
$proxy->persistentConnection = $this->persistentConnection;
$proxy->requestHeaders = $this->requestHeaders;
$proxy->soap_defencoding = $this->soap_defencoding;
$proxy->endpoint = $this->endpoint;
$proxy->forceEndpoint = $this->forceEndpoint;
return $proxy;
}
/**
* dynamically creates proxy class code
*
* @return string PHP/NuSOAP code for the proxy class
* @access private
*/
function _getProxyClassCode($r) {
if ($this->endpointType != 'wsdl') {
$evalStr = 'A proxy can only be created for a WSDL client';
$this
->setError($evalStr);
return $evalStr;
}
$evalStr = '';
foreach ($this->operations as $operation => $opData) {
if ($operation != '') {
// create param string and param comment string
if (sizeof($opData['input']['parts']) > 0) {
$paramStr = '';
$paramArrayStr = '';
$paramCommentStr = '';
foreach ($opData['input']['parts'] as $name => $type) {
$paramStr .= "\${$name}, ";
$paramArrayStr .= "'{$name}' => \${$name}, ";
$paramCommentStr .= "{$type} \${$name}, ";
}
$paramStr = substr($paramStr, 0, strlen($paramStr) - 2);
$paramArrayStr = substr($paramArrayStr, 0, strlen($paramArrayStr) - 2);
$paramCommentStr = substr($paramCommentStr, 0, strlen($paramCommentStr) - 2);
}
else {
$paramStr = '';
$paramCommentStr = 'void';
}
$opData['namespace'] = !isset($opData['namespace']) ? 'http://testuri.com' : $opData['namespace'];
$evalStr .= "// {$paramCommentStr}\n\tfunction " . str_replace('.', '__', $operation) . "({$paramStr}) {\n\t\t\$params = array({$paramArrayStr});\n\t\treturn \$this->call('{$operation}', \$params, '" . $opData['namespace'] . "', '" . (isset($opData['soapAction']) ? $opData['soapAction'] : '') . "');\n\t}\n\t";
unset($paramStr);
unset($paramCommentStr);
}
}
$evalStr = 'class soap_proxy_' . $r . ' extends nusoapclient {
' . $evalStr . '
}';
return $evalStr;
}
/**
* dynamically creates proxy class code
*
* @return string PHP/NuSOAP code for the proxy class
* @access public
*/
function getProxyClassCode() {
$r = rand();
return $this
->_getProxyClassCode($r);
}
/**
* gets the HTTP body for the current request.
*
* @param string $soapmsg The SOAP payload
* @return string The HTTP body, which includes the SOAP payload
* @access private
*/
function getHTTPBody($soapmsg) {
return $soapmsg;
}
/**
* gets the HTTP content type for the current request.
*
* Note: getHTTPBody must be called before this.
*
* @return string the HTTP content type for the current request.
* @access private
*/
function getHTTPContentType() {
return 'text/xml';
}
/**
* gets the HTTP content type charset for the current request.
* returns false for non-text content types.
*
* Note: getHTTPBody must be called before this.
*
* @return string the HTTP content type charset for the current request.
* @access private
*/
function getHTTPContentTypeCharset() {
return $this->soap_defencoding;
}
/*
* whether or not parser should decode utf8 element content
*
* @return always returns true
* @access public
*/
function decodeUTF8($bool) {
$this->decode_utf8 = $bool;
return true;
}
/**
* adds a new Cookie into $this->cookies array
*
* @param string $name Cookie Name
* @param string $value Cookie Value
* @return if cookie-set was successful returns true, else false
* @access public
*/
function setCookie($name, $value) {
if (strlen($name) == 0) {
return false;
}
$this->cookies[] = array(
'name' => $name,
'value' => $value,
);
return true;
}
/**
* gets all Cookies
*
* @return array with all internal cookies
* @access public
*/
function getCookies() {
return $this->cookies;
}
/**
* checks all Cookies and delete those which are expired
*
* @return always return true
* @access private
*/
function checkCookies() {
if (sizeof($this->cookies) == 0) {
return true;
}
$this
->debug('checkCookie: check ' . sizeof($this->cookies) . ' cookies');
$curr_cookies = $this->cookies;
$this->cookies = array();
foreach ($curr_cookies as $cookie) {
if (!is_array($cookie)) {
$this
->debug('Remove cookie that is not an array');
continue;
}
if (isset($cookie['expires']) && !empty($cookie['expires'])) {
if (strtotime($cookie['expires']) > time()) {
$this->cookies[] = $cookie;
}
else {
$this
->debug('Remove expired cookie ' . $cookie['name']);
}
}
else {
$this->cookies[] = $cookie;
}
}
$this
->debug('checkCookie: ' . sizeof($this->cookies) . ' cookies left in array');
return true;
}
/**
* updates the current cookies with a new set
*
* @param array $cookies new cookies with which to update current ones
* @return always return true
* @access private
*/
function UpdateCookies($cookies) {
if (sizeof($this->cookies) == 0) {
// no existing cookies: take whatever is new
if (sizeof($cookies) > 0) {
$this
->debug('Setting new cookie(s)');
$this->cookies = $cookies;
}
return true;
}
if (sizeof($cookies) == 0) {
// no new cookies: keep what we've got
return true;
}
// merge
foreach ($cookies as $newCookie) {
if (!is_array($newCookie)) {
continue;
}
if (!isset($newCookie['name']) || !isset($newCookie['value'])) {
continue;
}
$newName = $newCookie['name'];
$found = false;
for ($i = 0; $i < count($this->cookies); $i++) {
$cookie = $this->cookies[$i];
if (!is_array($cookie)) {
continue;
}
if (!isset($cookie['name'])) {
continue;
}
if ($newName != $cookie['name']) {
continue;
}
$newDomain = isset($newCookie['domain']) ? $newCookie['domain'] : 'NODOMAIN';
$domain = isset($cookie['domain']) ? $cookie['domain'] : 'NODOMAIN';
if ($newDomain != $domain) {
continue;
}
$newPath = isset($newCookie['path']) ? $newCookie['path'] : 'NOPATH';
$path = isset($cookie['path']) ? $cookie['path'] : 'NOPATH';
if ($newPath != $path) {
continue;
}
$this->cookies[$i] = $newCookie;
$found = true;
$this
->debug('Update cookie ' . $newName . '=' . $newCookie['value']);
break;
}
if (!$found) {
$this
->debug('Add cookie ' . $newName . '=' . $newCookie['value']);
$this->cookies[] = $newCookie;
}
}
return true;
}
}Members
Name |
Modifiers | Type | Description | Overrides |
|---|---|---|---|---|
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | * * @access public | ||
|
nusoapclient:: |
property | * * @access public | ||
|
nusoapclient:: |
property | * * @access public | ||
|
nusoapclient:: |
property | * * @access public | ||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
property | |||
|
nusoapclient:: |
function | * calls method, returns PHP native type * * | ||
|
nusoapclient:: |
function | * checks all Cookies and delete those which are expired * * | ||
|
nusoapclient:: |
function | |||
|
nusoapclient:: |
function | * gets all Cookies * * | ||
|
nusoapclient:: |
function | * gets the default RPC parameter setting. * If true, default is that call params are like RPC even for document style. * Each call() can override this value. * * This is no longer used. * * | ||
|
nusoapclient:: |
function | * get the SOAP response headers (namespace resolution incomplete) * * | ||
|
nusoapclient:: |
function | * gets the HTTP body for the current request. * * | ||
|
nusoapclient:: |
function | * gets the HTTP content type for the current request. * * Note: getHTTPBody must be called before this. * * | ||
|
nusoapclient:: |
function | * gets the HTTP content type charset for the current request. * returns false for non-text content types. * * Note: getHTTPBody must be called before this. * * | ||
|
nusoapclient:: |
function | * get available data pertaining to an operation * * | ||
|
nusoapclient:: |
function | * dynamically creates an instance of a proxy class, * allowing user to directly call methods from wsdl * * | ||
|
nusoapclient:: |
function | * dynamically creates proxy class code * * | ||
|
nusoapclient:: |
function | * constructor * * | ||
|
nusoapclient:: |
function | * processes SOAP message returned from server * * | ||
|
nusoapclient:: |
function | send the SOAP message | ||
|
nusoapclient:: |
function | * adds a new Cookie into $this->cookies array * * | ||
|
nusoapclient:: |
function | * if authenticating, set user credentials here * * | ||
|
nusoapclient:: |
function | * sets the default RPC parameter setting. * If true, default is that call params are like RPC even for document style * Each call() can override this value. * * This is no longer used. * * | ||
|
nusoapclient:: |
function | * sets the SOAP endpoint, which can override WSDL * * | ||
|
nusoapclient:: |
function | * set the SOAP headers * * | ||
|
nusoapclient:: |
function | * use HTTP encoding * * | ||
|
nusoapclient:: |
function | * set proxy info here * * | ||
|
nusoapclient:: |
function | * updates the current cookies with a new set * * | ||
|
nusoapclient:: |
function | * use HTTP persistent connections if possible * * @access public | ||
|
nusoapclient:: |
function | * dynamically creates proxy class code * * |