ilRpcClient Class Reference

Class ilRpcClient. More...

Collaboration diagram for ilRpcClient:

Public Member Functions
	__construct ($a_url, $a_prefix='', $a_timeout=0, $a_encoding='utf-8')
	ilRpcClient constructor. More...
	__call ($a_method, $a_params)
	Magic caller to all RPC functions. More...

Protected Attributes
	$url
	$prefix = ''
	$timeout = 0
	$encoding = ''

Detailed Description

Class ilRpcClient.

Author

Fabian Wolf wolf@.nosp@m.leif.nosp@m.os.co.nosp@m.m

List of all known RPC methods...

RPCIndexHandler: void index() index(string $client, bool $bool) Prefix/Package: RPCIndexHandler void indexObjects() indexObjects(string $client, array $object_ids) Prefix/Package: RPCIndexHandler

RPCTransformationHandler: string ilFO2PDF() ilFO2PDF(string $fo_string) Prefix/Package: RPCTransformationHandler Return: base64

RPCSearchHandler: string searchMail() searchMail(string $client, int $user_id, string $query, int $mail_folder_id) Prefix/Package: RPCSearchHandler Return:xml string highlight() highlight(string $client, array $object_ids, string $query) Prefix/Package: RPCSearchHandler Return: string string searchUsers() searchUser(string $client, string $query) Prefix/Package: RPCSearchHandler Return: xml string search() search(string $client, string $query, int $page_nr) Prefix/Package: RPCSearchHandler Return: xml

Other: void ping() ping() Prefix/Package: RPCebug void refreshSettings() refreshSettings(string $client) Prefix/Package: RPCAdministration

Definition at line 30 of file class.ilRpcClient.php.

Constructor & Destructor Documentation

__construct()

ilRpcClient::__construct	(		$a_url,
			$a_prefix = '',
			$a_timeout = 0,
			$a_encoding = 'utf-8'
	)

ilRpcClient constructor.

Parameters

string	$a_url	URL to connect to
string	$a_prefix	Optional prefix for method names
int	$a_timeout	The maximum number of seconds to allow ilRpcClient to connect.
string	$a_encoding	Character encoding

Exceptions

ilRpcClientException

Definition at line 49 of file class.ilRpcClient.php.

References ilLoggerFactory\getLogger(), and string.

        {
                if(!extension_loaded('xmlrpc'))
                {
                        ilLoggerFactory::getLogger('wsrv')->error('RpcClient Xmlrpc extension not enabled');
                        throw new ilRpcClientException('Xmlrpc extension not enabled.', 50);
                }

                $this->url = (string) $a_url;
                $this->prefix = (string) $a_prefix;
                $this->timeout = (int) $a_timeout;
                $this->encoding = (string) $a_encoding;
        }

Here is the call graph for this function:

Member Function Documentation

__call()

ilRpcClient::__call	(		$a_method,
			$a_params
	)

Magic caller to all RPC functions.

Parameters

string	$a_method	Method name
array	$a_params	Argument array

Returns

mixed Returns either an array, or an integer, or a string, or a boolean according to the response returned by the XMLRPC method.

Exceptions

ilRpcClientException

Definition at line 71 of file class.ilRpcClient.php.

References $encoding, array, and ilLoggerFactory\getLogger().

        {
                //prepare xml post data
                $method_name = str_replace('_', '.', $this->prefix . $a_method);
                $rpc_options = array(
                        'verbosity'=>'newlines_only',
                        'escaping' => 'markup'
                );

                if($this->encoding)
                {
                        $rpc_options['encoding'] = $this->encoding;
                }

                $post_data = xmlrpc_encode_request($method_name, $a_params,$rpc_options);

                //try to connect to the given url
                try
                {
                        include_once './Services/WebServices/Curl/classes/class.ilCurlConnection.php';
                        $curl = new ilCurlConnection($this->url);
                        $curl->init();
                        $curl->setOpt(CURLOPT_HEADER, 'Content-Type: text/xml');
                        $curl->setOpt(CURLOPT_POST, sizeof($post_data));
                        $curl->setOpt(CURLOPT_POSTFIELDS, $post_data);
                        $curl->setOpt(CURLOPT_RETURNTRANSFER , 1);

                        if($this->timeout > 0)
                        {
                                $curl->setOpt(CURLOPT_TIMEOUT, $this->timeout);
                        }
                        ilLoggerFactory::getLogger('wsrv')->info('RpcClient request to ' . $this->url . ' / ' . $method_name);
                        $xml_resp = $curl->exec();
                }
                catch(ilCurlConnectionException $e)
                {
                        ilLoggerFactory::getLogger('wsrv')->error('RpcClient could not connect to ' . $this->url  . ' Reason ' . $e->getCode() . ': ' .$e->getMessage());
                        throw new ilRpcClientException($e->getMessage(), $e->getCode());
                }

                //prepare output, throw exception if rpc fault is detected
                $resp = xmlrpc_decode($xml_resp,$this->encoding);

                //xmlrpc_is_fault can just handle arrays as response
                if(is_array($resp)&& xmlrpc_is_fault($resp))
                {
                        ilLoggerFactory::getLogger('wsrv')->error('RpcClient recieved error '. $resp['faultCode'] . ': ' . $resp['faultString'] );
                        include_once './Services/WebServices/RPC/classes/class.ilRpcClientException.php';
                        throw new ilRpcClientException('RPC-Server returned fault message: '.$resp['faultString'], $resp['faultCode']);
                }

                return $resp;
        }

Here is the call graph for this function:

Field Documentation

$encoding

ilRpcClient::$encoding = ''

protected

Definition at line 39 of file class.ilRpcClient.php.

Referenced by __call().

$prefix

ilRpcClient::$prefix = ''

protected

Definition at line 35 of file class.ilRpcClient.php.

$timeout

ilRpcClient::$timeout = 0

protected

Definition at line 37 of file class.ilRpcClient.php.

$url

ilRpcClient::$url

protected

Definition at line 33 of file class.ilRpcClient.php.

---

The documentation for this class was generated from the following file:

• Services/WebServices/RPC/classes/class.ilRpcClient.php