/DevApp/library/ServerLibraries/ZendFramework/1.7/library/Zend/XmlRpc/Client.php
PHP | 355 lines | 140 code | 46 blank | 169 comment | 15 complexity | 0fd8305da8261cc7785448470e8112e8 MD5 | raw file
Possible License(s): BSD-3-Clause, LGPL-2.0, MIT, Apache-2.0
- <?php
- /**
- * Zend Framework
- *
- * LICENSE
- *
- * This source file is subject to the new BSD license that is bundled
- * with this package in the file LICENSE.txt.
- * It is also available through the world-wide-web at this URL:
- * http://framework.zend.com/license/new-bsd
- * If you did not receive a copy of the license and are unable to
- * obtain it through the world-wide-web, please send an email
- * to license@zend.com so we can send you a copy immediately.
- *
- * @category Zend
- * @package Zend_XmlRpc
- * @subpackage Client
- * @copyright Copyright (c) 2005-2008 Zend Technologies USA Inc. (http://www.zend.com)
- * @license http://framework.zend.com/license/new-bsd New BSD License
- */
- /**
- * For handling the HTTP connection to the XML-RPC service
- * @see Zend_Http_Client
- */
- require_once 'Zend/Http/Client.php';
- /**
- * Enables object chaining for calling namespaced XML-RPC methods.
- * @see Zend_XmlRpc_Client_ServerProxy
- */
- require_once 'Zend/XmlRpc/Client/ServerProxy.php';
- /**
- * Introspects remote servers using the XML-RPC de facto system.* methods
- * @see Zend_XmlRpc_Client_ServerIntrospection
- */
- require_once 'Zend/XmlRpc/Client/ServerIntrospection.php';
- /**
- * Represent a native XML-RPC value, used both in sending parameters
- * to methods and as the parameters retrieve from method calls
- * @see Zend_XmlRpc_Value
- */
- require_once 'Zend/XmlRpc/Value.php';
- /**
- * XML-RPC Request
- * @see Zend_XmlRpc_Request
- */
- require_once 'Zend/XmlRpc/Request.php';
- /**
- * XML-RPC Response
- * @see Zend_XmlRpc_Response
- */
- require_once 'Zend/XmlRpc/Response.php';
- /**
- * XML-RPC Fault
- * @see Zend_XmlRpc_Fault
- */
- require_once 'Zend/XmlRpc/Fault.php';
- /**
- * An XML-RPC client implementation
- *
- * @category Zend
- * @package Zend_XmlRpc
- * @subpackage Client
- * @copyright Copyright (c) 2005-2008 Zend Technologies USA Inc. (http://www.zend.com)
- * @license http://framework.zend.com/license/new-bsd New BSD License
- */
- class Zend_XmlRpc_Client
- {
- /**
- * Full address of the XML-RPC service
- * @var string
- * @example http://time.xmlrpc.com/RPC2
- */
- protected $_serverAddress;
- /**
- * HTTP Client to use for requests
- * @var Zend_Http_Client
- */
- protected $_httpClient = null;
- /**
- * Introspection object
- * @var Zend_Http_Client_Introspector
- */
- protected $_introspector = null;
- /**
- * Request of the last method call
- * @var Zend_XmlRpc_Request
- */
- protected $_lastRequest = null;
- /**
- * Response received from the last method call
- * @var Zend_XmlRpc_Response
- */
- protected $_lastResponse = null;
- /**
- * Proxy object for more convenient method calls
- * @var array of Zend_XmlRpc_Client_ServerProxy
- */
- protected $_proxyCache = array();
- /**
- * Flag for skipping system lookup
- * @var bool
- */
- protected $_skipSystemLookup = false;
- /**
- * Create a new XML-RPC client to a remote server
- *
- * @param string $server Full address of the XML-RPC service
- * (e.g. http://time.xmlrpc.com/RPC2)
- * @param Zend_Http_Client $httpClient HTTP Client to use for requests
- * @return void
- */
- public function __construct($server, Zend_Http_Client $httpClient = null)
- {
- if ($httpClient === null) {
- $this->_httpClient = new Zend_Http_Client();
- } else {
- $this->_httpClient = $httpClient;
- }
- $this->_introspector = new Zend_XmlRpc_Client_ServerIntrospection($this);
- $this->_serverAddress = $server;
- }
- /**
- * Sets the HTTP client object to use for connecting the XML-RPC server.
- *
- * @param Zend_Http_Client $httpClient
- * @return Zend_Http_Client
- */
- public function setHttpClient(Zend_Http_Client $httpClient)
- {
- return $this->_httpClient = $httpClient;
- }
- /**
- * Gets the HTTP client object.
- *
- * @return Zend_Http_Client
- */
- public function getHttpClient()
- {
- return $this->_httpClient;
- }
- /**
- * Sets the object used to introspect remote servers
- *
- * @param Zend_XmlRpc_Client_ServerIntrospection
- * @return Zend_XmlRpc_Client_ServerIntrospection
- */
- public function setIntrospector(Zend_XmlRpc_Client_ServerIntrospection $introspector)
- {
- return $this->_introspector = $introspector;
- }
- /**
- * Gets the introspection object.
- *
- * @return Zend_XmlRpc_Client_ServerIntrospection
- */
- public function getIntrospector()
- {
- return $this->_introspector;
- }
- /**
- * The request of the last method call
- *
- * @return Zend_XmlRpc_Request
- */
- public function getLastRequest()
- {
- return $this->_lastRequest;
- }
- /**
- * The response received from the last method call
- *
- * @return Zend_XmlRpc_Response
- */
- public function getLastResponse()
- {
- return $this->_lastResponse;
- }
- /**
- * Returns a proxy object for more convenient method calls
- *
- * @param $namespace Namespace to proxy or empty string for none
- * @return Zend_XmlRpc_Client_ServerProxy
- */
- public function getProxy($namespace = '')
- {
- if (empty($this->_proxyCache[$namespace])) {
- $proxy = new Zend_XmlRpc_Client_ServerProxy($this, $namespace);
- $this->_proxyCache[$namespace] = $proxy;
- }
- return $this->_proxyCache[$namespace];
- }
- /**
- * Set skip system lookup flag
- *
- * @param bool $flag
- * @return Zend_XmlRpc_Client
- */
- public function setSkipSystemLookup($flag = true)
- {
- $this->_skipSystemLookup = (bool) $flag;
- return $this;
- }
- /**
- * Skip system lookup when determining if parameter should be array or struct?
- *
- * @return bool
- */
- public function skipSystemLookup()
- {
- return $this->_skipSystemLookup;
- }
- /**
- * Perform an XML-RPC request and return a response.
- *
- * @param Zend_XmlRpc_Request $request
- * @param null|Zend_XmlRpc_Response $response
- * @return void
- * @throws Zend_XmlRpc_Client_HttpException
- */
- public function doRequest($request, $response = null)
- {
- $this->_lastRequest = $request;
- iconv_set_encoding('input_encoding', 'UTF-8');
- iconv_set_encoding('output_encoding', 'UTF-8');
- iconv_set_encoding('internal_encoding', 'UTF-8');
- $http = $this->getHttpClient();
- if($http->getUri() === null) {
- $http->setUri($this->_serverAddress);
- }
- $http->setHeaders(array(
- 'Content-Type: text/xml; charset=utf-8',
- 'User-Agent: Zend_XmlRpc_Client',
- 'Accept: text/xml',
- ));
- $xml = $this->_lastRequest->__toString();
- $http->setRawData($xml);
- $httpResponse = $http->request(Zend_Http_Client::POST);
- if (! $httpResponse->isSuccessful()) {
- /**
- * Exception thrown when an HTTP error occurs
- * @see Zend_XmlRpc_Client_HttpException
- */
- require_once 'Zend/XmlRpc/Client/HttpException.php';
- throw new Zend_XmlRpc_Client_HttpException(
- $httpResponse->getMessage(),
- $httpResponse->getStatus());
- }
- if ($response === null) {
- $response = new Zend_XmlRpc_Response();
- }
- $this->_lastResponse = $response;
- $this->_lastResponse->loadXml($httpResponse->getBody());
- }
- /**
- * Send an XML-RPC request to the service (for a specific method)
- *
- * @param string $method Name of the method we want to call
- * @param array $params Array of parameters for the method
- * @return mixed
- * @throws Zend_XmlRpc_Client_FaultException
- */
- public function call($method, $params=array())
- {
- if (!$this->skipSystemLookup() && ('system.' != substr($method, 0, 7))) {
- // Ensure empty array/struct params are cast correctly
- // If system.* methods are not available, bypass. (ZF-2978)
- $success = true;
- try {
- $signatures = $this->getIntrospector()->getMethodSignature($method);
- } catch (Zend_XmlRpc_Exception $e) {
- $success = false;
- }
- if ($success) {
- foreach ($params as $key => $param) {
- if (is_array($param) && empty($param)) {
- $type = 'array';
- foreach ($signatures as $signature) {
- if (!is_array($signature)) {
- continue;
- }
- if (array_key_exists($key + 1, $signature)) {
- $type = $signature[$key + 1];
- $type = (in_array($type, array('array', 'struct'))) ? $type : 'array';
- break;
- }
- }
- $params[$key] = array(
- 'type' => $type,
- 'value' => $param
- );
- }
- }
- }
- }
- $request = new Zend_XmlRpc_Request($method, $params);
- $this->doRequest($request);
- if ($this->_lastResponse->isFault()) {
- $fault = $this->_lastResponse->getFault();
- /**
- * Exception thrown when an XML-RPC fault is returned
- * @see Zend_XmlRpc_Client_FaultException
- */
- require_once 'Zend/XmlRpc/Client/FaultException.php';
- throw new Zend_XmlRpc_Client_FaultException($fault->getMessage(),
- $fault->getCode());
- }
- return $this->_lastResponse->getReturnValue();
- }
- }