2011-09-26 22:42:21 +02:00
|
|
|
<?php
|
2011-10-03 21:03:46 +02:00
|
|
|
|
|
|
|
/*
|
2011-09-26 22:42:21 +02:00
|
|
|
* This file is part of the BeSimpleSoapClient.
|
|
|
|
*
|
|
|
|
* (c) Christian Kerl <christian-kerl@web.de>
|
|
|
|
* (c) Francis Besset <francis.besset@gmail.com>
|
|
|
|
*
|
|
|
|
* This source file is subject to the MIT license that is bundled
|
|
|
|
* with this source code in the file LICENSE.
|
|
|
|
*/
|
|
|
|
|
|
|
|
namespace BeSimple\SoapClient;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Soap helper class with static functions that are used in the client and
|
|
|
|
* server implementations. It also provides namespace and configuration
|
|
|
|
* constants.
|
|
|
|
*
|
|
|
|
* @author Andreas Schamberger
|
|
|
|
*/
|
|
|
|
class Helper
|
|
|
|
{
|
|
|
|
/**
|
|
|
|
* Attachment type: xsd:base64Binary (native in ext/soap).
|
|
|
|
*/
|
|
|
|
const ATTACHMENTS_TYPE_BASE64 = 1;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Attachment type: MTOM (SOAP Message Transmission Optimization Mechanism).
|
|
|
|
*/
|
|
|
|
const ATTACHMENTS_TYPE_MTOM = 2;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Attachment type: SWA (SOAP Messages with Attachments).
|
|
|
|
*/
|
|
|
|
const ATTACHMENTS_TYPE_SWA = 4;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Web Services Security: SOAP Message Security 1.0 (WS-Security 2004)
|
|
|
|
*/
|
|
|
|
const NAME_WSS_SMS = 'http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Web Services Security: SOAP Message Security 1.1 (WS-Security 2004)
|
|
|
|
*/
|
|
|
|
const NAME_WSS_SMS_1_1 = 'http://docs.oasis-open.org/wss/oasis-wss-soap-message-security-1.1';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Web Services Security UsernameToken Profile 1.0
|
|
|
|
*/
|
|
|
|
const NAME_WSS_UTP = 'http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Web Services Security X.509 Certificate Token Profile
|
|
|
|
*/
|
|
|
|
const NAME_WSS_X509 = 'http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Soap 1.1 namespace.
|
|
|
|
*/
|
|
|
|
const NS_SOAP_1_1 = 'http://schemas.xmlsoap.org/soap/envelope/';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Soap 1.1 namespace.
|
|
|
|
*/
|
|
|
|
const NS_SOAP_1_2 = 'http://www.w3.org/2003/05/soap-envelope/';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Web Services Addressing 1.0 namespace.
|
|
|
|
*/
|
|
|
|
const NS_WSA = 'http://www.w3.org/2005/08/addressing';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Web Services Security Extension namespace.
|
|
|
|
*/
|
|
|
|
const NS_WSS = 'http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Web Services Security Utility namespace.
|
|
|
|
*/
|
|
|
|
const NS_WSU = 'http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Describing Media Content of Binary Data in XML namespace.
|
|
|
|
*/
|
|
|
|
const NS_XMLMIME = 'http://www.w3.org/2004/11/xmlmime';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* XML Schema namespace.
|
|
|
|
*/
|
|
|
|
const NS_XML_SCHEMA = 'http://www.w3.org/2001/XMLSchema';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* XML Schema instance namespace.
|
|
|
|
*/
|
|
|
|
const NS_XML_SCHEMA_INSTANCE = 'http://www.w3.org/2001/XMLSchema-instance';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* XML-binary Optimized Packaging namespace.
|
|
|
|
*/
|
|
|
|
const NS_XOP = 'http://www.w3.org/2004/08/xop/include';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Web Services Addressing 1.0 prefix.
|
|
|
|
*/
|
|
|
|
const PFX_WSA = 'wsa';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Web Services Security Extension namespace.
|
|
|
|
*/
|
|
|
|
const PFX_WSS = 'wsse';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Web Services Security Utility namespace prefix.
|
|
|
|
*/
|
|
|
|
const PFX_WSU = 'wsu';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Describing Media Content of Binary Data in XML namespace prefix.
|
|
|
|
*/
|
|
|
|
const PFX_XMLMIME = 'xmlmime';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* XML Schema namespace prefix.
|
|
|
|
*/
|
|
|
|
const PFX_XML_SCHEMA = 'xsd';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* XML Schema instance namespace prefix.
|
|
|
|
*/
|
|
|
|
const PFX_XML_SCHEMA_INSTANCE = 'xsi';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* XML-binary Optimized Packaging namespace prefix.
|
|
|
|
*/
|
|
|
|
const PFX_XOP = 'xop';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Constant for a request.
|
|
|
|
*/
|
|
|
|
const REQUEST = 0;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Constant for a response.
|
|
|
|
*/
|
|
|
|
const RESPONSE = 1;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Wheather to format the XML output or not.
|
|
|
|
*
|
|
|
|
* @var boolean
|
|
|
|
*/
|
|
|
|
public static $formatXmlOutput = false;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Contains previously defined error handler string.
|
|
|
|
*
|
|
|
|
* @var string
|
|
|
|
*/
|
|
|
|
private static $previousErrorHandler = null;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* User-defined error handler function to convert errors to exceptions.
|
|
|
|
*
|
|
|
|
* @param string $errno
|
|
|
|
* @param string $errstr
|
|
|
|
* @param string $errfile
|
|
|
|
* @param string $errline
|
|
|
|
* @throws ErrorException
|
|
|
|
*/
|
2011-10-02 12:23:59 +02:00
|
|
|
public static function exceptionErrorHandler($errno, $errstr, $errfile, $errline)
|
2011-09-26 22:42:21 +02:00
|
|
|
{
|
|
|
|
// don't throw exception for errors suppresed with @
|
2011-10-02 12:23:59 +02:00
|
|
|
if (error_reporting() != 0) {
|
|
|
|
throw new \ErrorException($errstr, 0, $errno, $errfile, $errline);
|
2011-09-26 22:42:21 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Generate a pseudo-random version 4 UUID.
|
|
|
|
*
|
|
|
|
* @see http://de.php.net/manual/en/function.uniqid.php#94959
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public static function generateUUID()
|
|
|
|
{
|
|
|
|
return sprintf(
|
|
|
|
'%04x%04x-%04x-%04x-%04x-%04x%04x%04x',
|
|
|
|
// 32 bits for "time_low"
|
2011-10-02 12:23:59 +02:00
|
|
|
mt_rand(0, 0xffff), mt_rand(0, 0xffff),
|
2011-09-26 22:42:21 +02:00
|
|
|
// 16 bits for "time_mid"
|
2011-10-02 12:23:59 +02:00
|
|
|
mt_rand(0, 0xffff),
|
2011-09-26 22:42:21 +02:00
|
|
|
// 16 bits for "time_hi_and_version",
|
|
|
|
// four most significant bits holds version number 4
|
2011-10-02 12:23:59 +02:00
|
|
|
mt_rand(0, 0x0fff) | 0x4000,
|
2011-09-26 22:42:21 +02:00
|
|
|
// 16 bits, 8 bits for "clk_seq_hi_res",
|
|
|
|
// 8 bits for "clk_seq_low",
|
|
|
|
// two most significant bits holds zero and one for variant DCE1.1
|
2011-10-02 12:23:59 +02:00
|
|
|
mt_rand(0, 0x3fff) | 0x8000,
|
2011-09-26 22:42:21 +02:00
|
|
|
// 48 bits for "node"
|
2011-10-02 12:23:59 +02:00
|
|
|
mt_rand(0, 0xffff), mt_rand(0, 0xffff), mt_rand(0, 0xffff)
|
|
|
|
);
|
2011-09-26 22:42:21 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Builds the current URL from the $_SERVER array.
|
|
|
|
*
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public static function getCurrentUrl()
|
|
|
|
{
|
|
|
|
$url = '';
|
2011-10-02 12:23:59 +02:00
|
|
|
if (isset($_SERVER['HTTPS']) &&
|
|
|
|
(strtolower($_SERVER['HTTPS']) === 'on' || $_SERVER['HTTPS'] === '1')) {
|
2011-09-26 22:42:21 +02:00
|
|
|
$url .= 'https://';
|
2011-10-02 12:23:59 +02:00
|
|
|
} else {
|
2011-09-26 22:42:21 +02:00
|
|
|
$url .= 'http://';
|
|
|
|
}
|
2011-10-02 12:23:59 +02:00
|
|
|
$url .= isset($_SERVER['SERVER_NAME']) ? $_SERVER['SERVER_NAME'] : '';
|
|
|
|
if (isset($_SERVER['SERVER_PORT']) && $_SERVER['SERVER_PORT'] != 80) {
|
2011-09-26 22:42:21 +02:00
|
|
|
$url .= ":{$_SERVER['SERVER_PORT']}";
|
|
|
|
}
|
2011-10-02 12:23:59 +02:00
|
|
|
$url .= isset($_SERVER['REQUEST_URI']) ? $_SERVER['REQUEST_URI'] : '';
|
2011-09-26 22:42:21 +02:00
|
|
|
return $url;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get SOAP namespace for the given $version.
|
|
|
|
*
|
|
|
|
* @param int $version SOAP_1_1|SOAP_1_2
|
|
|
|
* @return string
|
|
|
|
*/
|
2011-10-02 12:23:59 +02:00
|
|
|
public static function getSoapNamespace($version)
|
2011-09-26 22:42:21 +02:00
|
|
|
{
|
2011-10-02 12:23:59 +02:00
|
|
|
if ($version === SOAP_1_2) {
|
2011-09-26 22:42:21 +02:00
|
|
|
return self::NS_SOAP_1_2;
|
2011-10-02 12:23:59 +02:00
|
|
|
} else {
|
2011-09-26 22:42:21 +02:00
|
|
|
return self::NS_SOAP_1_1;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get SOAP version from namespace URI.
|
|
|
|
*
|
|
|
|
* @param string $namespace NS_SOAP_1_1|NS_SOAP_1_2
|
|
|
|
* @return int SOAP_1_1|SOAP_1_2
|
|
|
|
*/
|
2011-10-02 12:23:59 +02:00
|
|
|
public static function getSoapVersionFromNamespace($namespace)
|
2011-09-26 22:42:21 +02:00
|
|
|
{
|
2011-10-02 12:23:59 +02:00
|
|
|
if ($namespace === self::NS_SOAP_1_2) {
|
2011-09-26 22:42:21 +02:00
|
|
|
return SOAP_1_2;
|
2011-10-02 12:23:59 +02:00
|
|
|
} else {
|
2011-09-26 22:42:21 +02:00
|
|
|
return SOAP_1_1;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Runs the registered Plugins on the given request $xml.
|
|
|
|
*
|
|
|
|
* @param array(\ass\Soap\Plugin) $plugins
|
|
|
|
* @param int $requestType \ass\Soap\Helper::REQUEST|\ass\Soap\Helper::RESPONSE
|
|
|
|
* @param string $xml
|
|
|
|
* @param string $location
|
|
|
|
* @param string $action
|
|
|
|
* @param \ass\Soap\WsdlHandler $wsdlHandler
|
|
|
|
* @return string
|
|
|
|
*/
|
2011-10-02 12:23:59 +02:00
|
|
|
public static function runPlugins(array $plugins, $requestType, $xml, $location = null, $action = null, \ass\Soap\WsdlHandler $wsdlHandler = null)
|
2011-09-26 22:42:21 +02:00
|
|
|
{
|
2011-10-02 12:23:59 +02:00
|
|
|
if (count($plugins) > 0) {
|
2011-09-26 22:42:21 +02:00
|
|
|
// instantiate new dom object
|
2011-10-02 12:23:59 +02:00
|
|
|
$dom = new \DOMDocument('1.0');
|
2011-09-26 22:42:21 +02:00
|
|
|
// format the XML if option is set
|
|
|
|
$dom->formatOutput = self::$formatXmlOutput;
|
2011-10-02 12:23:59 +02:00
|
|
|
$dom->loadXML($xml);
|
2011-09-26 22:42:21 +02:00
|
|
|
$params = array(
|
|
|
|
$dom,
|
|
|
|
$location,
|
|
|
|
$action,
|
|
|
|
$wsdlHandler
|
|
|
|
);
|
2011-10-02 12:23:59 +02:00
|
|
|
if ($requestType == self::REQUEST) {
|
2011-09-26 22:42:21 +02:00
|
|
|
$callMethod = 'modifyRequest';
|
2011-10-02 12:23:59 +02:00
|
|
|
} else {
|
2011-09-26 22:42:21 +02:00
|
|
|
$callMethod = 'modifyResponse';
|
|
|
|
}
|
|
|
|
// modify dom
|
2011-10-02 12:23:59 +02:00
|
|
|
foreach($plugins AS $plugin) {
|
|
|
|
if ($plugin instanceof \ass\Soap\Plugin) {
|
|
|
|
call_user_func_array(array($plugin, $callMethod), $params);
|
2011-09-26 22:42:21 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
// return the modified xml document
|
|
|
|
return $dom->saveXML();
|
|
|
|
// format the XML if option is set
|
2011-10-02 12:23:59 +02:00
|
|
|
} elseif (self::$formatXmlOutput === true) {
|
|
|
|
$dom = new \DOMDocument('1.0');
|
2011-09-26 22:42:21 +02:00
|
|
|
$dom->formatOutput = true;
|
2011-10-02 12:23:59 +02:00
|
|
|
$dom->loadXML($xml);
|
2011-09-26 22:42:21 +02:00
|
|
|
return $dom->saveXML();
|
|
|
|
}
|
|
|
|
return $xml;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set custom error handler that converts all php errors to ErrorExceptions
|
|
|
|
*
|
|
|
|
* @param boolean $reset
|
|
|
|
*/
|
2011-10-02 12:23:59 +02:00
|
|
|
public static function setCustomErrorHandler($reset = false)
|
2011-09-26 22:42:21 +02:00
|
|
|
{
|
2011-10-02 12:23:59 +02:00
|
|
|
if ($reset === true && !is_null(self::$previousErrorHandler)) {
|
|
|
|
set_error_handler(self::$previousErrorHandler);
|
2011-09-26 22:42:21 +02:00
|
|
|
self::$previousErrorHandler = null;
|
2011-10-02 12:23:59 +02:00
|
|
|
} else {
|
|
|
|
self::$previousErrorHandler = set_error_handler('ass\\Soap\\Helper::exceptionErrorHandler');
|
2011-09-26 22:42:21 +02:00
|
|
|
}
|
|
|
|
return self::$previousErrorHandler;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Build data string to used to bridge ext/soap
|
|
|
|
* 'SOAP_MIME_ATTACHMENT:cid=...&type=...'
|
|
|
|
*
|
|
|
|
* @param string $contentId
|
|
|
|
* @param string $contentType
|
|
|
|
* @return string
|
|
|
|
*/
|
2011-10-02 12:23:59 +02:00
|
|
|
public static function makeSoapAttachmentDataString($contentId, $contentType)
|
2011-09-26 22:42:21 +02:00
|
|
|
{
|
|
|
|
$parameter = array(
|
|
|
|
'cid' => $contentId,
|
|
|
|
'type' => $contentType,
|
|
|
|
);
|
2011-10-02 12:23:59 +02:00
|
|
|
return 'SOAP-MIME-ATTACHMENT:' . http_build_query($parameter, null, '&');
|
2011-09-26 22:42:21 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Parse data string used to bridge ext/soap
|
|
|
|
* 'SOAP_MIME_ATTACHMENT:cid=...&type=...'
|
|
|
|
*
|
|
|
|
* @param string $dataString
|
|
|
|
* @return array(string=>string)
|
|
|
|
*/
|
2011-10-02 12:23:59 +02:00
|
|
|
public static function parseSoapAttachmentDataString($dataString)
|
2011-09-26 22:42:21 +02:00
|
|
|
{
|
2011-10-02 12:23:59 +02:00
|
|
|
$dataString = substr($dataString, 21);
|
2011-09-26 22:42:21 +02:00
|
|
|
// get all data
|
|
|
|
$data = array();
|
2011-10-02 12:23:59 +02:00
|
|
|
parse_str($dataString, $data);
|
2011-09-26 22:42:21 +02:00
|
|
|
return $data;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Function to set proper http status header.
|
|
|
|
* Neccessary as there is a difference between mod_php and the cgi SAPIs.
|
|
|
|
*
|
|
|
|
* @param string $header
|
|
|
|
*/
|
2011-10-02 12:23:59 +02:00
|
|
|
public static function setHttpStatusHeader($header)
|
2011-09-26 22:42:21 +02:00
|
|
|
{
|
2011-10-02 12:23:59 +02:00
|
|
|
if ('cgi' == substr(php_sapi_name(), 0, 3)) {
|
|
|
|
header('Status: ' . $header);
|
|
|
|
} else {
|
|
|
|
header($_SERVER['SERVER_PROTOCOL'] . ' ' . $header);
|
2011-09-26 22:42:21 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|