CI_Xmlrpcs Class Reference

Inheritance diagram for CI_Xmlrpcs:

[legend]

Collaboration diagram for CI_Xmlrpcs:

[legend]

List of all members.

Public Member Functions
	CI_Xmlrpcs ($config=array())
	initialize ($config=array())
	set_system_methods ()
	serve ()
	add_to_map ($methodname, $function, $sig, $doc)
	parseRequest ($data='')
	_execute ($m)
	listMethods ($m)
	methodSignature ($m)
	methodHelp ($m)
	multicall ($m)
	multicall_error ($err)
	do_multicall ($call)
Public Attributes
	$methods = array()
	$debug_msg = ''
	$system_methods = array()
	$controller_obj
	$object = FALSE

---

Detailed Description

Definition at line 37 of file Xmlrpcs.php.

---

Member Function Documentation

CI_Xmlrpcs::_execute

(

$

m

)

Definition at line 243 of file Xmlrpcs.php.

References $CI, and get_instance().

Referenced by do_multicall(), multicall(), and parseRequest().

        {
                $methName = $m->method_name;
                
                // Check to see if it is a system call
                $system_call = (strncmp($methName, 'system', 5) == 0) ? TRUE : FALSE;
                
                //-------------------------------------
                //  Valid Method
                //-------------------------------------
                
                if ( ! isset($this->methods[$methName]['function']))
                {
                        return new XML_RPC_Response(0, $this->xmlrpcerr['unknown_method'], $this->xmlrpcstr['unknown_method']);
                }
                
                //-------------------------------------
                //  Check for Method (and Object)
                //-------------------------------------
                        
                $method_parts = explode(".", $this->methods[$methName]['function']);
                $objectCall = (isset($method_parts['1']) && $method_parts['1'] != "") ? TRUE : FALSE;
                
                if ($system_call === TRUE)
                {
                        if ( ! is_callable(array($this,$method_parts['1'])))
                        {
                                return new XML_RPC_Response(0, $this->xmlrpcerr['unknown_method'], $this->xmlrpcstr['unknown_method']);
                        }
                }
                else
                {
                        if ($objectCall && ! is_callable(array($method_parts['0'],$method_parts['1'])))
                        {
                                return new XML_RPC_Response(0, $this->xmlrpcerr['unknown_method'], $this->xmlrpcstr['unknown_method']);
                        }
                        elseif ( ! $objectCall && ! is_callable($this->methods[$methName]['function']))
                        {
                                return new XML_RPC_Response(0, $this->xmlrpcerr['unknown_method'], $this->xmlrpcstr['unknown_method']);
                        }
                }
                
                //-------------------------------------
                //  Checking Methods Signature
                //-------------------------------------
                
                if (isset($this->methods[$methName]['signature']))
                {
                        $sig = $this->methods[$methName]['signature'];
                        for($i=0; $i<sizeof($sig); $i++)
                        {
                                $current_sig = $sig[$i];
                
                                if (sizeof($current_sig) == sizeof($m->params)+1)
                                {
                                        for($n=0; $n < sizeof($m->params); $n++)
                                        {
                                                $p = $m->params[$n];
                                                $pt = ($p->kindOf() == 'scalar') ? $p->scalarval() : $p->kindOf();
                                                
                                                if ($pt != $current_sig[$n+1])
                                                {
                                                        $pno = $n+1;
                                                        $wanted = $current_sig[$n+1];
                                                        
                                                        return new XML_RPC_Response(0,
                                                                $this->xmlrpcerr['incorrect_params'],
                                                                $this->xmlrpcstr['incorrect_params'] .
                                                                ": Wanted {$wanted}, got {$pt} at param {$pno})");
                                                }
                                        }
                                }
                        }
                }

                //-------------------------------------
                //  Calls the Function
                //-------------------------------------

                if ($objectCall === TRUE)
                {
                        if ($method_parts[0] == "this" && $system_call == TRUE)
                        {
                                return call_user_func(array($this, $method_parts[1]), $m);
                        }
                        else
                        {
                                if ($this->object === FALSE)
                                {
                                        $CI =& get_instance();
                                        return $CI->$method_parts['1']($m);
                                }
                                else
                                {
                                        return $this->object->$method_parts['1']($m);
                                        //return call_user_func(array(&$method_parts['0'],$method_parts['1']), $m);
                                }
                        }
                }
                else
                {
                        return call_user_func($this->methods[$methName]['function'], $m);
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

CI_Xmlrpcs::add_to_map	(	$	methodname,
		$	function,
		$	sig,
		$	doc
	)

Definition at line 133 of file Xmlrpcs.php.

        {
                $this->methods[$methodname] = array(
                        'function'  => $function,
                        'signature' => $sig,
                        'docstring' => $doc
                );
        }

CI_Xmlrpcs::CI_Xmlrpcs

(

$

config = array()

)

Definition at line 51 of file Xmlrpcs.php.

References $config, CI_Xmlrpc::CI_Xmlrpc(), log_message(), and set_system_methods().

        {       
                parent::CI_Xmlrpc();
                $this->set_system_methods();
        
                if (isset($config['functions']) && is_array($config['functions']))
                {
                        $this->methods = array_merge($this->methods, $config['functions']);
                }
                
                log_message('debug', "XML-RPC Server Class Initialized");
        }

Here is the call graph for this function:

CI_Xmlrpcs::do_multicall

(

$

call

)

Definition at line 493 of file Xmlrpcs.php.

References CI_Xmlrpc::$result, _execute(), and multicall_error().

        {
                if ($call->kindOf() != 'struct')
                        return $this->multicall_error('notstruct');
                elseif ( ! $methName = $call->me['struct']['methodName'])
                        return $this->multicall_error('nomethod');
                
                list($scalar_type,$scalar_value)=each($methName->me);
                $scalar_type = $scalar_type == $this->xmlrpcI4 ? $this->xmlrpcInt : $scalar_type;
                        
                if ($methName->kindOf() != 'scalar' OR $scalar_type != 'string')
                        return $this->multicall_error('notstring');
                elseif ($scalar_value == 'system.multicall')
                        return $this->multicall_error('recursion');
                elseif ( ! $params = $call->me['struct']['params'])
                        return $this->multicall_error('noparams');
                elseif ($params->kindOf() != 'array')
                        return $this->multicall_error('notarray');
                        
                list($a,$b)=each($params->me);
                $numParams = sizeof($b);

                $msg = new XML_RPC_Message($scalar_value);
                for ($i = 0; $i < $numParams; $i++)
                {
                        $msg->params[] = $params->me['array'][$i];
                }

                $result = $this->_execute($msg);

                if ($result->faultCode() != 0)
                {
                        return $this->multicall_error($result);
                }

                return new XML_RPC_Values(array($result->value()), 'array');
        }       

Here is the call graph for this function:

CI_Xmlrpcs::initialize

(

$

config = array()

)

Reimplemented from CI_Xmlrpc.

Definition at line 68 of file Xmlrpcs.php.

References $config.

        {       
                if (isset($config['functions']) && is_array($config['functions']))
                {
                        $this->methods = array_merge($this->methods, $config['functions']);
                }
                
                if (isset($config['debug']))
                {
                        $this->debug = $config['debug'];
                }
                
                if (isset($config['object']) && is_object($config['object']))
                {
                        $this->object = $config['object'];
                }
        }

CI_Xmlrpcs::listMethods

(

$

m

)

Definition at line 353 of file Xmlrpcs.php.

        {
                $v = new XML_RPC_Values();
                $output = array();
                
                foreach($this->methods as $key => $value)
                {
                        $output[] = new XML_RPC_Values($key, 'string');
                }
                
                foreach($this->system_methods as $key => $value)
                {
                        $output[]= new XML_RPC_Values($key, 'string');
                }

                $v->addArray($output);
                return new XML_RPC_Response($v);
        }

CI_Xmlrpcs::methodHelp

(

$

m

)

Definition at line 416 of file Xmlrpcs.php.

        {
                $parameters = $m->output_parameters();
                $method_name = $parameters[0];
        
                if (isset($this->methods[$method_name]))
                {
                        $docstring = isset($this->methods[$method_name]['docstring']) ? $this->methods[$method_name]['docstring'] : '';
                        
                        return new XML_RPC_Response(new XML_RPC_Values($docstring, 'string'));
                }
                else
                {
                        return new XML_RPC_Response(0, $this->xmlrpcerr['introspect_unknown'], $this->xmlrpcstr['introspect_unknown']);
                }
        }

CI_Xmlrpcs::methodSignature

(

$

m

)

Definition at line 376 of file Xmlrpcs.php.

        {
                $parameters = $m->output_parameters();
                $method_name = $parameters[0];
                
                if (isset($this->methods[$method_name]))
                {
                        if ($this->methods[$method_name]['signature'])
                        {
                                $sigs = array();
                                $signature = $this->methods[$method_name]['signature'];
                                
                                for($i=0; $i < sizeof($signature); $i++)
                                {
                                        $cursig = array();
                                        $inSig = $signature[$i];
                                        for($j=0; $j<sizeof($inSig); $j++)
                                        {
                                                $cursig[]= new XML_RPC_Values($inSig[$j], 'string');
                                        }
                                        $sigs[]= new XML_RPC_Values($cursig, 'array');
                                }
                                $r = new XML_RPC_Response(new XML_RPC_Values($sigs, 'array'));
                        }
                        else
                        {
                                $r = new XML_RPC_Response(new XML_RPC_Values('undef', 'string'));
                        }
                }
                else
                {
                        $r = new XML_RPC_Response(0,$this->xmlrpcerr['introspect_unknown'], $this->xmlrpcstr['introspect_unknown']);
                }
                return $r;
        }

CI_Xmlrpcs::multicall

(

$

m

)

Definition at line 437 of file Xmlrpcs.php.

References CI_Xmlrpc::$result, and _execute().

        {
                // Disabled
                return new XML_RPC_Response(0, $this->xmlrpcerr['unknown_method'], $this->xmlrpcstr['unknown_method']);
                
                $parameters = $m->output_parameters();
                $calls = $parameters[0];

                $result = array();

                foreach ($calls as $value)
                {
                        //$attempt = $this->_execute(new XML_RPC_Message($value[0], $value[1]));
                        
                        $m = new XML_RPC_Message($value[0]);
                        $plist='';
                        
                        for($i=0; $i < sizeof($value[1]); $i++)
                        {
                                $m->addParam(new XML_RPC_Values($value[1][$i], 'string'));
                        }
                        
                        $attempt = $this->_execute($m);

                        if ($attempt->faultCode() != 0)
                        {
                                return $attempt;
                        }

                        $result[] = new XML_RPC_Values(array($attempt->value()), 'array');
                }

                return new XML_RPC_Response(new XML_RPC_Values($result, 'array'));
        }

Here is the call graph for this function:

CI_Xmlrpcs::multicall_error

(

$

err

)

Definition at line 477 of file Xmlrpcs.php.

Referenced by do_multicall().

        {
                $str  = is_string($err) ? $this->xmlrpcstr["multicall_${err}"] : $err->faultString();
                $code = is_string($err) ? $this->xmlrpcerr["multicall_${err}"] : $err->faultCode();
                
                $struct['faultCode'] = new XML_RPC_Values($code, 'int');
                $struct['faultString'] = new XML_RPC_Values($str, 'string');
        
                return new XML_RPC_Values($struct, 'struct');
        }

Here is the caller graph for this function:

CI_Xmlrpcs::parseRequest

(

$

data = ''

)

Definition at line 147 of file Xmlrpcs.php.

References CI_Xmlrpc::$data, and _execute().

Referenced by serve().

        {
                global $HTTP_RAW_POST_DATA;
                
                //-------------------------------------
                //  Get Data
                //-------------------------------------

                if ($data == '')
                {
                        $data = $HTTP_RAW_POST_DATA;
                }

                //-------------------------------------
                //  Set up XML Parser
                //-------------------------------------
                
                $parser = xml_parser_create($this->xmlrpc_defencoding);
                $parser_object = new XML_RPC_Message("filler");
                
                $parser_object->xh[$parser]                                     = array();
                $parser_object->xh[$parser]['isf']                      = 0;
                $parser_object->xh[$parser]['isf_reason']       = '';
                $parser_object->xh[$parser]['params']           = array();
                $parser_object->xh[$parser]['stack']            = array();
                $parser_object->xh[$parser]['valuestack']       = array();
                $parser_object->xh[$parser]['method']           = '';

                xml_set_object($parser, $parser_object);
                xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, true);
                xml_set_element_handler($parser, 'open_tag', 'closing_tag');
                xml_set_character_data_handler($parser, 'character_data');
                //xml_set_default_handler($parser, 'default_handler');
                
                
                //-------------------------------------
                //  PARSE + PROCESS XML DATA
                //-------------------------------------         
                
                if ( ! xml_parse($parser, $data, 1))
                {
                        // return XML error as a faultCode
                        $r = new XML_RPC_Response(0,
                        $this->xmlrpcerrxml + xml_get_error_code($parser),
                        sprintf('XML error: %s at line %d',
                                xml_error_string(xml_get_error_code($parser)),
                                xml_get_current_line_number($parser)));
                        xml_parser_free($parser);
                }
                elseif($parser_object->xh[$parser]['isf'])
                {
                        return new XML_RPC_Response(0, $this->xmlrpcerr['invalid_return'], $this->xmlrpcstr['invalid_return']);
                }
                else
                {
                        xml_parser_free($parser);
                        
                        $m = new XML_RPC_Message($parser_object->xh[$parser]['method']);
                        $plist='';
                        
                        for($i=0; $i < sizeof($parser_object->xh[$parser]['params']); $i++)
                        {
                                if ($this->debug === TRUE)
                                {
                                        $plist .= "$i - " .  print_r(get_object_vars($parser_object->xh[$parser]['params'][$i]), TRUE). ";\n";
                                }
                                
                                $m->addParam($parser_object->xh[$parser]['params'][$i]);
                        }
                        
                        if ($this->debug === TRUE)
                        {
                                echo "<pre>";
                                echo "---PLIST---\n" . $plist . "\n---PLIST END---\n\n";
                                echo "</pre>";
                        }
                        
                        $r = $this->_execute($m);
                }
                
                //-------------------------------------
                //  SET DEBUGGING MESSAGE
                //-------------------------------------         
                
                if ($this->debug === TRUE)
                {
                        $this->debug_msg = "<!-- DEBUG INFO:\n\n".$plist."\n END DEBUG-->\n";
                }
                
                return $r;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

CI_Xmlrpcs::serve

(

)

Definition at line 117 of file Xmlrpcs.php.

References parseRequest().

        {
                $r = $this->parseRequest();
                $payload  = '<?xml version="1.0" encoding="'.$this->xmlrpc_defencoding.'"?'.'>'."\n";
                $payload .= $this->debug_msg;
                $payload .= $r->prepare_response();
                
                header("Content-Type: text/xml");
                header("Content-Length: ".strlen($payload));
                echo $payload;
        }

Here is the call graph for this function:

CI_Xmlrpcs::set_system_methods

(

)

Definition at line 90 of file Xmlrpcs.php.

Referenced by CI_Xmlrpcs().

        {
                $this->methods = array(
                                        'system.listMethods'     => array(
                                                                                                        'function' => 'this.listMethods',
                                                                                                        'signature' => array(array($this->xmlrpcArray, $this->xmlrpcString), array($this->xmlrpcArray)),
                                                                                                        'docstring' => 'Returns an array of available methods on this server'),
                                        'system.methodHelp'              => array(
                                                                                                        'function' => 'this.methodHelp',
                                                                                                        'signature' => array(array($this->xmlrpcString, $this->xmlrpcString)),
                                                                                                        'docstring' => 'Returns a documentation string for the specified method'),
                                        'system.methodSignature' => array(
                                                                                                        'function' => 'this.methodSignature',
                                                                                                        'signature' => array(array($this->xmlrpcArray, $this->xmlrpcString)),
                                                                                                        'docstring' => 'Returns an array describing the return type and required parameters of a method'),
                                        'system.multicall'               => array(
                                                                                                'function' => 'this.multicall',
                                                                                                'signature' => array(array($this->xmlrpcArray, $this->xmlrpcArray)),
                                                                                                'docstring' => 'Combine multiple RPC calls in one request. See http://www.xmlrpc.com/discuss/msgReader$1208 for details')
                                        );
        }

Here is the caller graph for this function:

---

Member Data Documentation

CI_Xmlrpcs::$controller_obj

Definition at line 42 of file Xmlrpcs.php.

CI_Xmlrpcs::$debug_msg = ''

Definition at line 40 of file Xmlrpcs.php.

CI_Xmlrpcs::$methods = array()

Definition at line 39 of file Xmlrpcs.php.

CI_Xmlrpcs::$object = FALSE

Definition at line 44 of file Xmlrpcs.php.

CI_Xmlrpcs::$system_methods = array()

Definition at line 41 of file Xmlrpcs.php.

---

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

• Xmlrpcs.php