Non puoi selezionare più di 25 argomenti
Gli argomenti devono iniziare con una lettera o un numero, possono includere trattini ('-') e possono essere lunghi fino a 35 caratteri.
996 righe
28 KiB
996 righe
28 KiB
<?php |
|
|
|
/* |
|
$Id: class.nusoap_base.php,v 1.56 2010/04/26 20:15:08 snichol Exp $ |
|
|
|
NuSOAP - Web Services Toolkit for PHP |
|
|
|
Copyright (c) 2002 NuSphere Corporation |
|
|
|
This library is free software; you can redistribute it and/or |
|
modify it under the terms of the GNU Lesser General Public |
|
License as published by the Free Software Foundation; either |
|
version 2.1 of the License, or (at your option) any later version. |
|
|
|
This library is distributed in the hope that it will be useful, |
|
but WITHOUT ANY WARRANTY; without even the implied warranty of |
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
|
Lesser General Public License for more details. |
|
|
|
You should have received a copy of the GNU Lesser General Public |
|
License along with this library; if not, write to the Free Software |
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
|
|
|
The NuSOAP project home is: |
|
http://sourceforge.net/projects/nusoap/ |
|
|
|
The primary support for NuSOAP is the Help forum on the project home page. |
|
|
|
If you have any questions or comments, please email: |
|
|
|
Dietrich Ayala |
|
dietrich@ganx4.com |
|
http://dietrich.ganx4.com/nusoap |
|
|
|
NuSphere Corporation |
|
http://www.nusphere.com |
|
|
|
*/ |
|
|
|
/* |
|
* Some of the standards implmented in whole or part by NuSOAP: |
|
* |
|
* SOAP 1.1 (http://www.w3.org/TR/2000/NOTE-SOAP-20000508/) |
|
* WSDL 1.1 (http://www.w3.org/TR/2001/NOTE-wsdl-20010315) |
|
* SOAP Messages With Attachments (http://www.w3.org/TR/SOAP-attachments) |
|
* XML 1.0 (http://www.w3.org/TR/2006/REC-xml-20060816/) |
|
* Namespaces in XML 1.0 (http://www.w3.org/TR/2006/REC-xml-names-20060816/) |
|
* XML Schema 1.0 (http://www.w3.org/TR/xmlschema-0/) |
|
* RFC 2045 Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies |
|
* RFC 2068 Hypertext Transfer Protocol -- HTTP/1.1 |
|
* RFC 2617 HTTP Authentication: Basic and Digest Access Authentication |
|
*/ |
|
|
|
/* load classes |
|
|
|
// necessary classes |
|
require_once('class.soapclient.php'); |
|
require_once('class.soap_val.php'); |
|
require_once('class.soap_parser.php'); |
|
require_once('class.soap_fault.php'); |
|
|
|
// transport classes |
|
require_once('class.soap_transport_http.php'); |
|
|
|
// optional add-on classes |
|
require_once('class.xmlschema.php'); |
|
require_once('class.wsdl.php'); |
|
|
|
// server class |
|
require_once('class.soap_server.php');*/ |
|
|
|
// class variable emulation |
|
// cf. http://www.webkreator.com/php/techniques/php-static-class-variables.html |
|
$GLOBALS['_transient']['static']['nusoap_base']['globalDebugLevel'] = 9; |
|
|
|
/** |
|
* |
|
* nusoap_base |
|
* |
|
* @author Dietrich Ayala <dietrich@ganx4.com> |
|
* @author Scott Nichol <snichol@users.sourceforge.net> |
|
* @version $Id: class.nusoap_base.php,v 1.56 2010/04/26 20:15:08 snichol Exp $ |
|
* @access public |
|
*/ |
|
class nusoap_base { |
|
/** |
|
* Identification for HTTP headers. |
|
* |
|
* @var string |
|
* @access private |
|
*/ |
|
var $title = 'NuSOAP'; |
|
/** |
|
* Version for HTTP headers. |
|
* |
|
* @var string |
|
* @access private |
|
*/ |
|
var $version = '0.9.5'; |
|
/** |
|
* CVS revision for HTTP headers. |
|
* |
|
* @var string |
|
* @access private |
|
*/ |
|
var $revision = '$Revision: 1.56 $'; |
|
/** |
|
* Current error string (manipulated by getError/setError) |
|
* |
|
* @var string |
|
* @access private |
|
*/ |
|
var $error_str = ''; |
|
/** |
|
* Current debug string (manipulated by debug/appendDebug/clearDebug/getDebug/getDebugAsXMLComment) |
|
* |
|
* @var string |
|
* @access private |
|
*/ |
|
var $debug_str = ''; |
|
/** |
|
* toggles automatic encoding of special characters as entities |
|
* (should always be true, I think) |
|
* |
|
* @var boolean |
|
* @access private |
|
*/ |
|
var $charencoding = true; |
|
/** |
|
* the debug level for this instance |
|
* |
|
* @var integer |
|
* @access private |
|
*/ |
|
var $debugLevel; |
|
|
|
/** |
|
* set schema version |
|
* |
|
* @var string |
|
* @access public |
|
*/ |
|
var $XMLSchemaVersion = 'http://www.w3.org/2001/XMLSchema'; |
|
|
|
/** |
|
* charset encoding for outgoing messages |
|
* |
|
* @var string |
|
* @access public |
|
*/ |
|
var $soap_defencoding = 'ISO-8859-1'; |
|
//var $soap_defencoding = 'UTF-8'; |
|
|
|
/** |
|
* namespaces in an array of prefix => uri |
|
* |
|
* this is "seeded" by a set of constants, but it may be altered by code |
|
* |
|
* @var array |
|
* @access public |
|
*/ |
|
var $namespaces = array( |
|
'SOAP-ENV' => 'http://schemas.xmlsoap.org/soap/envelope/', |
|
'xsd' => 'http://www.w3.org/2001/XMLSchema', |
|
'xsi' => 'http://www.w3.org/2001/XMLSchema-instance', |
|
'SOAP-ENC' => 'http://schemas.xmlsoap.org/soap/encoding/' |
|
); |
|
|
|
/** |
|
* namespaces used in the current context, e.g. during serialization |
|
* |
|
* @var array |
|
* @access private |
|
*/ |
|
var $usedNamespaces = array(); |
|
|
|
/** |
|
* XML Schema types in an array of uri => (array of xml type => php type) |
|
* is this legacy yet? |
|
* no, this is used by the nusoap_xmlschema class to verify type => namespace mappings. |
|
* @var array |
|
* @access public |
|
*/ |
|
var $typemap = array( |
|
'http://www.w3.org/2001/XMLSchema' => array( |
|
'string'=>'string','boolean'=>'boolean','float'=>'double','double'=>'double','decimal'=>'double', |
|
'duration'=>'','dateTime'=>'string','time'=>'string','date'=>'string','gYearMonth'=>'', |
|
'gYear'=>'','gMonthDay'=>'','gDay'=>'','gMonth'=>'','hexBinary'=>'string','base64Binary'=>'string', |
|
// abstract "any" types |
|
'anyType'=>'string','anySimpleType'=>'string', |
|
// derived datatypes |
|
'normalizedString'=>'string','token'=>'string','language'=>'','NMTOKEN'=>'','NMTOKENS'=>'','Name'=>'','NCName'=>'','ID'=>'', |
|
'IDREF'=>'','IDREFS'=>'','ENTITY'=>'','ENTITIES'=>'','integer'=>'integer','nonPositiveInteger'=>'integer', |
|
'negativeInteger'=>'integer','long'=>'integer','int'=>'integer','short'=>'integer','byte'=>'integer','nonNegativeInteger'=>'integer', |
|
'unsignedLong'=>'','unsignedInt'=>'','unsignedShort'=>'','unsignedByte'=>'','positiveInteger'=>''), |
|
'http://www.w3.org/2000/10/XMLSchema' => array( |
|
'i4'=>'','int'=>'integer','boolean'=>'boolean','string'=>'string','double'=>'double', |
|
'float'=>'double','dateTime'=>'string', |
|
'timeInstant'=>'string','base64Binary'=>'string','base64'=>'string','ur-type'=>'array'), |
|
'http://www.w3.org/1999/XMLSchema' => array( |
|
'i4'=>'','int'=>'integer','boolean'=>'boolean','string'=>'string','double'=>'double', |
|
'float'=>'double','dateTime'=>'string', |
|
'timeInstant'=>'string','base64Binary'=>'string','base64'=>'string','ur-type'=>'array'), |
|
'http://soapinterop.org/xsd' => array('SOAPStruct'=>'struct'), |
|
'http://schemas.xmlsoap.org/soap/encoding/' => array('base64'=>'string','array'=>'array','Array'=>'array'), |
|
'http://xml.apache.org/xml-soap' => array('Map') |
|
); |
|
|
|
/** |
|
* XML entities to convert |
|
* |
|
* @var array |
|
* @access public |
|
* @deprecated |
|
* @see expandEntities |
|
*/ |
|
var $xmlEntities = array('quot' => '"','amp' => '&', |
|
'lt' => '<','gt' => '>','apos' => "'"); |
|
|
|
/** |
|
* constructor |
|
* |
|
* @access public |
|
*/ |
|
function nusoap_base() { |
|
$this->debugLevel = $GLOBALS['_transient']['static']['nusoap_base']['globalDebugLevel']; |
|
} |
|
|
|
/** |
|
* gets the global debug level, which applies to future instances |
|
* |
|
* @return integer Debug level 0-9, where 0 turns off |
|
* @access public |
|
*/ |
|
function getGlobalDebugLevel() { |
|
return $GLOBALS['_transient']['static']['nusoap_base']['globalDebugLevel']; |
|
} |
|
|
|
/** |
|
* sets the global debug level, which applies to future instances |
|
* |
|
* @param int $level Debug level 0-9, where 0 turns off |
|
* @access public |
|
*/ |
|
function setGlobalDebugLevel($level) { |
|
$GLOBALS['_transient']['static']['nusoap_base']['globalDebugLevel'] = $level; |
|
} |
|
|
|
/** |
|
* gets the debug level for this instance |
|
* |
|
* @return int Debug level 0-9, where 0 turns off |
|
* @access public |
|
*/ |
|
function getDebugLevel() { |
|
return $this->debugLevel; |
|
} |
|
|
|
/** |
|
* sets the debug level for this instance |
|
* |
|
* @param int $level Debug level 0-9, where 0 turns off |
|
* @access public |
|
*/ |
|
function setDebugLevel($level) { |
|
$this->debugLevel = $level; |
|
} |
|
|
|
/** |
|
* adds debug data to the instance debug string with formatting |
|
* |
|
* @param string $string debug data |
|
* @access private |
|
*/ |
|
function debug($string){ |
|
if ($this->debugLevel > 0) { |
|
$this->appendDebug($this->getmicrotime().' '.get_class($this).": $string\n"); |
|
} |
|
} |
|
|
|
/** |
|
* adds debug data to the instance debug string without formatting |
|
* |
|
* @param string $string debug data |
|
* @access public |
|
*/ |
|
function appendDebug($string){ |
|
if ($this->debugLevel > 0) { |
|
// it would be nice to use a memory stream here to use |
|
// memory more efficiently |
|
$this->debug_str .= $string; |
|
} |
|
} |
|
|
|
/** |
|
* clears the current debug data for this instance |
|
* |
|
* @access public |
|
*/ |
|
function clearDebug() { |
|
// it would be nice to use a memory stream here to use |
|
// memory more efficiently |
|
$this->debug_str = ''; |
|
} |
|
|
|
/** |
|
* gets the current debug data for this instance |
|
* |
|
* @return debug data |
|
* @access public |
|
*/ |
|
function &getDebug() { |
|
// it would be nice to use a memory stream here to use |
|
// memory more efficiently |
|
return $this->debug_str; |
|
} |
|
|
|
/** |
|
* gets the current debug data for this instance as an XML comment |
|
* this may change the contents of the debug data |
|
* |
|
* @return debug data as an XML comment |
|
* @access public |
|
*/ |
|
function &getDebugAsXMLComment() { |
|
// it would be nice to use a memory stream here to use |
|
// memory more efficiently |
|
while (strpos($this->debug_str, '--')) { |
|
$this->debug_str = str_replace('--', '- -', $this->debug_str); |
|
} |
|
$ret = "<!--\n" . $this->debug_str . "\n-->"; |
|
return $ret; |
|
} |
|
|
|
/** |
|
* expands entities, e.g. changes '<' to '<'. |
|
* |
|
* @param string $val The string in which to expand entities. |
|
* @access private |
|
*/ |
|
function expandEntities($val) { |
|
if ($this->charencoding) { |
|
$val = str_replace('&', '&', $val); |
|
$val = str_replace("'", ''', $val); |
|
$val = str_replace('"', '"', $val); |
|
$val = str_replace('<', '<', $val); |
|
$val = str_replace('>', '>', $val); |
|
} |
|
return $val; |
|
} |
|
|
|
/** |
|
* returns error string if present |
|
* |
|
* @return mixed error string or false |
|
* @access public |
|
*/ |
|
function getError(){ |
|
if($this->error_str != ''){ |
|
return $this->error_str; |
|
} |
|
return false; |
|
} |
|
|
|
/** |
|
* sets error string |
|
* |
|
* @return boolean $string error string |
|
* @access private |
|
*/ |
|
function setError($str){ |
|
$this->error_str = $str; |
|
} |
|
|
|
/** |
|
* detect if array is a simple array or a struct (associative array) |
|
* |
|
* @param mixed $val The PHP array |
|
* @return string (arraySimple|arrayStruct) |
|
* @access private |
|
*/ |
|
function isArraySimpleOrStruct($val) { |
|
$keyList = array_keys($val); |
|
foreach ($keyList as $keyListValue) { |
|
if (!is_int($keyListValue)) { |
|
return 'arrayStruct'; |
|
} |
|
} |
|
return 'arraySimple'; |
|
} |
|
|
|
/** |
|
* serializes PHP values in accordance w/ section 5. Type information is |
|
* not serialized if $use == 'literal'. |
|
* |
|
* @param mixed $val The value to serialize |
|
* @param string $name The name (local part) of the XML element |
|
* @param string $type The XML schema type (local part) for the element |
|
* @param string $name_ns The namespace for the name of the XML element |
|
* @param string $type_ns The namespace for the type of the element |
|
* @param array $attributes The attributes to serialize as name=>value pairs |
|
* @param string $use The WSDL "use" (encoded|literal) |
|
* @param boolean $soapval Whether this is called from soapval. |
|
* @return string The serialized element, possibly with child elements |
|
* @access public |
|
*/ |
|
function serialize_val($val,$name=false,$type=false,$name_ns=false,$type_ns=false,$attributes=false,$use='encoded',$soapval=false) { |
|
$this->debug("in serialize_val: name=$name, type=$type, name_ns=$name_ns, type_ns=$type_ns, use=$use, soapval=$soapval"); |
|
$this->appendDebug('value=' . $this->varDump($val)); |
|
$this->appendDebug('attributes=' . $this->varDump($attributes)); |
|
|
|
if (is_object($val) && get_class($val) == 'soapval' && (! $soapval)) { |
|
$this->debug("serialize_val: serialize soapval"); |
|
$xml = $val->serialize($use); |
|
$this->appendDebug($val->getDebug()); |
|
$val->clearDebug(); |
|
$this->debug("serialize_val of soapval returning $xml"); |
|
return $xml; |
|
} |
|
// force valid name if necessary |
|
if (is_numeric($name)) { |
|
$name = '__numeric_' . $name; |
|
} elseif (! $name) { |
|
$name = 'noname'; |
|
} |
|
// if name has ns, add ns prefix to name |
|
$xmlns = ''; |
|
if($name_ns){ |
|
$prefix = 'nu'.rand(1000,9999); |
|
$name = $prefix.':'.$name; |
|
$xmlns .= " xmlns:$prefix=\"$name_ns\""; |
|
} |
|
// if type is prefixed, create type prefix |
|
if($type_ns != '' && $type_ns == $this->namespaces['xsd']){ |
|
// need to fix this. shouldn't default to xsd if no ns specified |
|
// w/o checking against typemap |
|
$type_prefix = 'xsd'; |
|
} elseif($type_ns){ |
|
$type_prefix = 'ns'.rand(1000,9999); |
|
$xmlns .= " xmlns:$type_prefix=\"$type_ns\""; |
|
} |
|
// serialize attributes if present |
|
$atts = ''; |
|
if($attributes){ |
|
foreach($attributes as $k => $v){ |
|
$atts .= " $k=\"".$this->expandEntities($v).'"'; |
|
} |
|
} |
|
// serialize null value |
|
if (is_null($val)) { |
|
$this->debug("serialize_val: serialize null"); |
|
if ($use == 'literal') { |
|
// TODO: depends on minOccurs |
|
$xml = "<$name$xmlns$atts/>"; |
|
$this->debug("serialize_val returning $xml"); |
|
return $xml; |
|
} else { |
|
if (isset($type) && isset($type_prefix)) { |
|
$type_str = " xsi:type=\"$type_prefix:$type\""; |
|
} else { |
|
$type_str = ''; |
|
} |
|
$xml = "<$name$xmlns$type_str$atts xsi:nil=\"true\"/>"; |
|
$this->debug("serialize_val returning $xml"); |
|
return $xml; |
|
} |
|
} |
|
// serialize if an xsd built-in primitive type |
|
if($type != '' && isset($this->typemap[$this->XMLSchemaVersion][$type])){ |
|
$this->debug("serialize_val: serialize xsd built-in primitive type"); |
|
if (is_bool($val)) { |
|
if ($type == 'boolean') { |
|
$val = $val ? 'true' : 'false'; |
|
} elseif (! $val) { |
|
$val = 0; |
|
} |
|
} else if (is_string($val)) { |
|
$val = $this->expandEntities($val); |
|
} |
|
if ($use == 'literal') { |
|
$xml = "<$name$xmlns$atts>$val</$name>"; |
|
$this->debug("serialize_val returning $xml"); |
|
return $xml; |
|
} else { |
|
$xml = "<$name$xmlns xsi:type=\"xsd:$type\"$atts>$val</$name>"; |
|
$this->debug("serialize_val returning $xml"); |
|
return $xml; |
|
} |
|
} |
|
// detect type and serialize |
|
$xml = ''; |
|
switch(true) { |
|
case (is_bool($val) || $type == 'boolean'): |
|
$this->debug("serialize_val: serialize boolean"); |
|
if ($type == 'boolean') { |
|
$val = $val ? 'true' : 'false'; |
|
} elseif (! $val) { |
|
$val = 0; |
|
} |
|
if ($use == 'literal') { |
|
$xml .= "<$name$xmlns$atts>$val</$name>"; |
|
} else { |
|
$xml .= "<$name$xmlns xsi:type=\"xsd:boolean\"$atts>$val</$name>"; |
|
} |
|
break; |
|
case (is_int($val) || is_long($val) || $type == 'int'): |
|
$this->debug("serialize_val: serialize int"); |
|
if ($use == 'literal') { |
|
$xml .= "<$name$xmlns$atts>$val</$name>"; |
|
} else { |
|
$xml .= "<$name$xmlns xsi:type=\"xsd:int\"$atts>$val</$name>"; |
|
} |
|
break; |
|
case (is_float($val)|| is_double($val) || $type == 'float'): |
|
$this->debug("serialize_val: serialize float"); |
|
if ($use == 'literal') { |
|
$xml .= "<$name$xmlns$atts>$val</$name>"; |
|
} else { |
|
$xml .= "<$name$xmlns xsi:type=\"xsd:float\"$atts>$val</$name>"; |
|
} |
|
break; |
|
case (is_string($val) || $type == 'string'): |
|
$this->debug("serialize_val: serialize string"); |
|
$val = $this->expandEntities($val); |
|
if ($use == 'literal') { |
|
$xml .= "<$name$xmlns$atts>$val</$name>"; |
|
} else { |
|
$xml .= "<$name$xmlns xsi:type=\"xsd:string\"$atts>$val</$name>"; |
|
} |
|
break; |
|
case is_object($val): |
|
$this->debug("serialize_val: serialize object"); |
|
if (get_class($val) == 'soapval') { |
|
$this->debug("serialize_val: serialize soapval object"); |
|
$pXml = $val->serialize($use); |
|
$this->appendDebug($val->getDebug()); |
|
$val->clearDebug(); |
|
} else { |
|
if (! $name) { |
|
$name = get_class($val); |
|
$this->debug("In serialize_val, used class name $name as element name"); |
|
} else { |
|
$this->debug("In serialize_val, do not override name $name for element name for class " . get_class($val)); |
|
} |
|
foreach(get_object_vars($val) as $k => $v){ |
|
$pXml = isset($pXml) ? $pXml.$this->serialize_val($v,$k,false,false,false,false,$use) : $this->serialize_val($v,$k,false,false,false,false,$use); |
|
} |
|
} |
|
if(isset($type) && isset($type_prefix)){ |
|
$type_str = " xsi:type=\"$type_prefix:$type\""; |
|
} else { |
|
$type_str = ''; |
|
} |
|
if ($use == 'literal') { |
|
$xml .= "<$name$xmlns$atts>$pXml</$name>"; |
|
} else { |
|
$xml .= "<$name$xmlns$type_str$atts>$pXml</$name>"; |
|
} |
|
break; |
|
break; |
|
case (is_array($val) || $type): |
|
// detect if struct or array |
|
$valueType = $this->isArraySimpleOrStruct($val); |
|
if($valueType=='arraySimple' || preg_match('/^ArrayOf/',$type)){ |
|
$this->debug("serialize_val: serialize array"); |
|
$i = 0; |
|
if(is_array($val) && count($val)> 0){ |
|
foreach($val as $v){ |
|
if(is_object($v) && get_class($v) == 'soapval'){ |
|
$tt_ns = $v->type_ns; |
|
$tt = $v->type; |
|
} elseif (is_array($v)) { |
|
$tt = $this->isArraySimpleOrStruct($v); |
|
} else { |
|
$tt = gettype($v); |
|
} |
|
$array_types[$tt] = 1; |
|
// TODO: for literal, the name should be $name |
|
$xml .= $this->serialize_val($v,'item',false,false,false,false,$use); |
|
++$i; |
|
} |
|
if(count($array_types) > 1){ |
|
$array_typename = 'xsd:anyType'; |
|
} elseif(isset($tt) && isset($this->typemap[$this->XMLSchemaVersion][$tt])) { |
|
if ($tt == 'integer') { |
|
$tt = 'int'; |
|
} |
|
$array_typename = 'xsd:'.$tt; |
|
} elseif(isset($tt) && $tt == 'arraySimple'){ |
|
$array_typename = 'SOAP-ENC:Array'; |
|
} elseif(isset($tt) && $tt == 'arrayStruct'){ |
|
$array_typename = 'unnamed_struct_use_soapval'; |
|
} else { |
|
// if type is prefixed, create type prefix |
|
if ($tt_ns != '' && $tt_ns == $this->namespaces['xsd']){ |
|
$array_typename = 'xsd:' . $tt; |
|
} elseif ($tt_ns) { |
|
$tt_prefix = 'ns' . rand(1000, 9999); |
|
$array_typename = "$tt_prefix:$tt"; |
|
$xmlns .= " xmlns:$tt_prefix=\"$tt_ns\""; |
|
} else { |
|
$array_typename = $tt; |
|
} |
|
} |
|
$array_type = $i; |
|
if ($use == 'literal') { |
|
$type_str = ''; |
|
} else if (isset($type) && isset($type_prefix)) { |
|
$type_str = " xsi:type=\"$type_prefix:$type\""; |
|
} else { |
|
$type_str = " xsi:type=\"SOAP-ENC:Array\" SOAP-ENC:arrayType=\"".$array_typename."[$array_type]\""; |
|
} |
|
// empty array |
|
} else { |
|
if ($use == 'literal') { |
|
$type_str = ''; |
|
} else if (isset($type) && isset($type_prefix)) { |
|
$type_str = " xsi:type=\"$type_prefix:$type\""; |
|
} else { |
|
$type_str = " xsi:type=\"SOAP-ENC:Array\" SOAP-ENC:arrayType=\"xsd:anyType[0]\""; |
|
} |
|
} |
|
// TODO: for array in literal, there is no wrapper here |
|
$xml = "<$name$xmlns$type_str$atts>".$xml."</$name>"; |
|
} else { |
|
// got a struct |
|
$this->debug("serialize_val: serialize struct"); |
|
if(isset($type) && isset($type_prefix)){ |
|
$type_str = " xsi:type=\"$type_prefix:$type\""; |
|
} else { |
|
$type_str = ''; |
|
} |
|
if ($use == 'literal') { |
|
$xml .= "<$name$xmlns$atts>"; |
|
} else { |
|
$xml .= "<$name$xmlns$type_str$atts>"; |
|
} |
|
foreach($val as $k => $v){ |
|
// Apache Map |
|
if ($type == 'Map' && $type_ns == 'http://xml.apache.org/xml-soap') { |
|
$xml .= '<item>'; |
|
$xml .= $this->serialize_val($k,'key',false,false,false,false,$use); |
|
$xml .= $this->serialize_val($v,'value',false,false,false,false,$use); |
|
$xml .= '</item>'; |
|
} else { |
|
$xml .= $this->serialize_val($v,$k,false,false,false,false,$use); |
|
} |
|
} |
|
$xml .= "</$name>"; |
|
} |
|
break; |
|
default: |
|
$this->debug("serialize_val: serialize unknown"); |
|
$xml .= 'not detected, got '.gettype($val).' for '.$val; |
|
break; |
|
} |
|
$this->debug("serialize_val returning $xml"); |
|
return $xml; |
|
} |
|
|
|
/** |
|
* serializes a message |
|
* |
|
* @param string $body the XML of the SOAP body |
|
* @param mixed $headers optional string of XML with SOAP header content, or array of soapval objects for SOAP headers, or associative array |
|
* @param array $namespaces optional the namespaces used in generating the body and headers |
|
* @param string $style optional (rpc|document) |
|
* @param string $use optional (encoded|literal) |
|
* @param string $encodingStyle optional (usually 'http://schemas.xmlsoap.org/soap/encoding/' for encoded) |
|
* @return string the message |
|
* @access public |
|
*/ |
|
function serializeEnvelope($body,$headers=false,$namespaces=array(),$style='rpc',$use='encoded',$encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'){ |
|
// TODO: add an option to automatically run utf8_encode on $body and $headers |
|
// if $this->soap_defencoding is UTF-8. Not doing this automatically allows |
|
// one to send arbitrary UTF-8 characters, not just characters that map to ISO-8859-1 |
|
|
|
$this->debug("In serializeEnvelope length=" . strlen($body) . " body (max 1000 characters)=" . substr($body, 0, 1000) . " style=$style use=$use encodingStyle=$encodingStyle"); |
|
$this->debug("headers:"); |
|
$this->appendDebug($this->varDump($headers)); |
|
$this->debug("namespaces:"); |
|
$this->appendDebug($this->varDump($namespaces)); |
|
|
|
// serialize namespaces |
|
$ns_string = ''; |
|
foreach(array_merge($this->namespaces,$namespaces) as $k => $v){ |
|
$ns_string .= " xmlns:$k=\"$v\""; |
|
} |
|
if($encodingStyle) { |
|
$ns_string = " SOAP-ENV:encodingStyle=\"$encodingStyle\"$ns_string"; |
|
} |
|
|
|
// serialize headers |
|
if($headers){ |
|
if (is_array($headers)) { |
|
$xml = ''; |
|
foreach ($headers as $k => $v) { |
|
if (is_object($v) && get_class($v) == 'soapval') { |
|
$xml .= $this->serialize_val($v, false, false, false, false, false, $use); |
|
} else { |
|
$xml .= $this->serialize_val($v, $k, false, false, false, false, $use); |
|
} |
|
} |
|
$headers = $xml; |
|
$this->debug("In serializeEnvelope, serialized array of headers to $headers"); |
|
} |
|
$headers = "<SOAP-ENV:Header>".$headers."</SOAP-ENV:Header>"; |
|
} |
|
// serialize envelope |
|
return |
|
'<?xml version="1.0" encoding="'.$this->soap_defencoding .'"?'.">". |
|
'<SOAP-ENV:Envelope'.$ns_string.">". |
|
$headers. |
|
"<SOAP-ENV:Body>". |
|
$body. |
|
"</SOAP-ENV:Body>". |
|
"</SOAP-ENV:Envelope>"; |
|
} |
|
|
|
/** |
|
* formats a string to be inserted into an HTML stream |
|
* |
|
* @param string $str The string to format |
|
* @return string The formatted string |
|
* @access public |
|
* @deprecated |
|
*/ |
|
function formatDump($str){ |
|
$str = htmlspecialchars($str); |
|
return nl2br($str); |
|
} |
|
|
|
/** |
|
* contracts (changes namespace to prefix) a qualified name |
|
* |
|
* @param string $qname qname |
|
* @return string contracted qname |
|
* @access private |
|
*/ |
|
function contractQname($qname){ |
|
// get element namespace |
|
//$this->xdebug("Contract $qname"); |
|
if (strrpos($qname, ':')) { |
|
// get unqualified name |
|
$name = substr($qname, strrpos($qname, ':') + 1); |
|
// get ns |
|
$ns = substr($qname, 0, strrpos($qname, ':')); |
|
$p = $this->getPrefixFromNamespace($ns); |
|
if ($p) { |
|
return $p . ':' . $name; |
|
} |
|
return $qname; |
|
} else { |
|
return $qname; |
|
} |
|
} |
|
|
|
/** |
|
* expands (changes prefix to namespace) a qualified name |
|
* |
|
* @param string $qname qname |
|
* @return string expanded qname |
|
* @access private |
|
*/ |
|
function expandQname($qname){ |
|
// get element prefix |
|
if(strpos($qname,':') && !preg_match('/^http:\/\//',$qname)){ |
|
// get unqualified name |
|
$name = substr(strstr($qname,':'),1); |
|
// get ns prefix |
|
$prefix = substr($qname,0,strpos($qname,':')); |
|
if(isset($this->namespaces[$prefix])){ |
|
return $this->namespaces[$prefix].':'.$name; |
|
} else { |
|
return $qname; |
|
} |
|
} else { |
|
return $qname; |
|
} |
|
} |
|
|
|
/** |
|
* returns the local part of a prefixed string |
|
* returns the original string, if not prefixed |
|
* |
|
* @param string $str The prefixed string |
|
* @return string The local part |
|
* @access public |
|
*/ |
|
function getLocalPart($str){ |
|
if($sstr = strrchr($str,':')){ |
|
// get unqualified name |
|
return substr( $sstr, 1 ); |
|
} else { |
|
return $str; |
|
} |
|
} |
|
|
|
/** |
|
* returns the prefix part of a prefixed string |
|
* returns false, if not prefixed |
|
* |
|
* @param string $str The prefixed string |
|
* @return mixed The prefix or false if there is no prefix |
|
* @access public |
|
*/ |
|
function getPrefix($str){ |
|
if($pos = strrpos($str,':')){ |
|
// get prefix |
|
return substr($str,0,$pos); |
|
} |
|
return false; |
|
} |
|
|
|
/** |
|
* pass it a prefix, it returns a namespace |
|
* |
|
* @param string $prefix The prefix |
|
* @return mixed The namespace, false if no namespace has the specified prefix |
|
* @access public |
|
*/ |
|
function getNamespaceFromPrefix($prefix){ |
|
if (isset($this->namespaces[$prefix])) { |
|
return $this->namespaces[$prefix]; |
|
} |
|
//$this->setError("No namespace registered for prefix '$prefix'"); |
|
return false; |
|
} |
|
|
|
/** |
|
* returns the prefix for a given namespace (or prefix) |
|
* or false if no prefixes registered for the given namespace |
|
* |
|
* @param string $ns The namespace |
|
* @return mixed The prefix, false if the namespace has no prefixes |
|
* @access public |
|
*/ |
|
function getPrefixFromNamespace($ns) { |
|
foreach ($this->namespaces as $p => $n) { |
|
if ($ns == $n || $ns == $p) { |
|
$this->usedNamespaces[$p] = $n; |
|
return $p; |
|
} |
|
} |
|
return false; |
|
} |
|
|
|
/** |
|
* returns the time in ODBC canonical form with microseconds |
|
* |
|
* @return string The time in ODBC canonical form with microseconds |
|
* @access public |
|
*/ |
|
function getmicrotime() { |
|
if (function_exists('gettimeofday')) { |
|
$tod = gettimeofday(); |
|
$sec = $tod['sec']; |
|
$usec = $tod['usec']; |
|
} else { |
|
$sec = time(); |
|
$usec = 0; |
|
} |
|
return strftime('%Y-%m-%d %H:%M:%S', $sec) . '.' . sprintf('%06d', $usec); |
|
} |
|
|
|
/** |
|
* Returns a string with the output of var_dump |
|
* |
|
* @param mixed $data The variable to var_dump |
|
* @return string The output of var_dump |
|
* @access public |
|
*/ |
|
function varDump($data) { |
|
ob_start(); |
|
var_dump($data); |
|
$ret_val = ob_get_contents(); |
|
ob_end_clean(); |
|
return $ret_val; |
|
} |
|
|
|
/** |
|
* represents the object as a string |
|
* |
|
* @return string |
|
* @access public |
|
*/ |
|
function __toString() { |
|
return $this->varDump($this); |
|
} |
|
} |
|
|
|
// XML Schema Datatype Helper Functions |
|
|
|
//xsd:dateTime helpers |
|
|
|
/** |
|
* convert unix timestamp to ISO 8601 compliant date string |
|
* |
|
* @param int $timestamp Unix time stamp |
|
* @param boolean $utc Whether the time stamp is UTC or local |
|
* @return mixed ISO 8601 date string or false |
|
* @access public |
|
*/ |
|
function timestamp_to_iso8601($timestamp,$utc=true){ |
|
$datestr = date('Y-m-d\TH:i:sO',$timestamp); |
|
$pos = strrpos($datestr, "+"); |
|
if ($pos === FALSE) { |
|
$pos = strrpos($datestr, "-"); |
|
} |
|
if ($pos !== FALSE) { |
|
if (strlen($datestr) == $pos + 5) { |
|
$datestr = substr($datestr, 0, $pos + 3) . ':' . substr($datestr, -2); |
|
} |
|
} |
|
if($utc){ |
|
$pattern = '/'. |
|
'([0-9]{4})-'. // centuries & years CCYY- |
|
'([0-9]{2})-'. // months MM- |
|
'([0-9]{2})'. // days DD |
|
'T'. // separator T |
|
'([0-9]{2}):'. // hours hh: |
|
'([0-9]{2}):'. // minutes mm: |
|
'([0-9]{2})(\.[0-9]*)?'. // seconds ss.ss... |
|
'(Z|[+\-][0-9]{2}:?[0-9]{2})?'. // Z to indicate UTC, -/+HH:MM:SS.SS... for local tz's |
|
'/'; |
|
|
|
if(preg_match($pattern,$datestr,$regs)){ |
|
return sprintf('%04d-%02d-%02dT%02d:%02d:%02dZ',$regs[1],$regs[2],$regs[3],$regs[4],$regs[5],$regs[6]); |
|
} |
|
return false; |
|
} else { |
|
return $datestr; |
|
} |
|
} |
|
|
|
/** |
|
* convert ISO 8601 compliant date string to unix timestamp |
|
* |
|
* @param string $datestr ISO 8601 compliant date string |
|
* @return mixed Unix timestamp (int) or false |
|
* @access public |
|
*/ |
|
function iso8601_to_timestamp($datestr){ |
|
$pattern = '/'. |
|
'([0-9]{4})-'. // centuries & years CCYY- |
|
'([0-9]{2})-'. // months MM- |
|
'([0-9]{2})'. // days DD |
|
'T'. // separator T |
|
'([0-9]{2}):'. // hours hh: |
|
'([0-9]{2}):'. // minutes mm: |
|
'([0-9]{2})(\.[0-9]+)?'. // seconds ss.ss... |
|
'(Z|[+\-][0-9]{2}:?[0-9]{2})?'. // Z to indicate UTC, -/+HH:MM:SS.SS... for local tz's |
|
'/'; |
|
if(preg_match($pattern,$datestr,$regs)){ |
|
// not utc |
|
if($regs[8] != 'Z'){ |
|
$op = substr($regs[8],0,1); |
|
$h = substr($regs[8],1,2); |
|
$m = substr($regs[8],strlen($regs[8])-2,2); |
|
if($op == '-'){ |
|
$regs[4] = $regs[4] + $h; |
|
$regs[5] = $regs[5] + $m; |
|
} elseif($op == '+'){ |
|
$regs[4] = $regs[4] - $h; |
|
$regs[5] = $regs[5] - $m; |
|
} |
|
} |
|
return gmmktime($regs[4], $regs[5], $regs[6], $regs[2], $regs[3], $regs[1]); |
|
// return strtotime("$regs[1]-$regs[2]-$regs[3] $regs[4]:$regs[5]:$regs[6]Z"); |
|
} else { |
|
return false; |
|
} |
|
} |
|
|
|
/** |
|
* sleeps some number of microseconds |
|
* |
|
* @param string $usec the number of microseconds to sleep |
|
* @access public |
|
* @deprecated |
|
*/ |
|
function usleepWindows($usec) |
|
{ |
|
$start = gettimeofday(); |
|
|
|
do |
|
{ |
|
$stop = gettimeofday(); |
|
$timePassed = 1000000 * ($stop['sec'] - $start['sec']) |
|
+ $stop['usec'] - $start['usec']; |
|
} |
|
while ($timePassed < $usec); |
|
} |
|
|
|
|
|
?>
|