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().

    {
        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 70 of file class.ilRpcClient.php.

References $encoding, 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, (strlen($post_data) > 0));
            $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