API Documentation RunningExamples server.ipv6addr set main PHP

Aus EUserv Wiki

Wechseln zu: Navigation, Suche

back to API Documentation


//includes the class library
$xmlrpc_internalencoding = 'UTF-8';


//defines the function
function server_ipv6addr_set_main($host,$port,$username,$password,$api_path,$srv_id)
	//creates the serverurl
	$serverurl = 'https://'.$host.':'.$port.'/'.$api_path;

	//----------creates the message which will be send to the server----------

	//creates the request for the XML-RPC Server
	$request = new xmlrpcmsg('server.ipv6addr_set_main');

	//adds parameters to the request
			//creates a value of type struct which contains an array with the username, password and server ID
			new xmlrpcval
							//creates a value of type string which contains the "$username"
							'login' => new xmlrpcval($username, 'string'),
							//creates a value of type string which contains the "$password"
							'password' => new xmlrpcval($password, 'string'),
							//creates a value of type int which contains the "$srv_id"
							'srv_id' => new xmlrpcval($srv_id, 'int')

	//----------creates the XML-RPC client which represent a client of an XML-RPC server----------

	//creates the client
	$client = new xmlrpc_client($serverurl);

	//disable SSL Keycheck

	//----------sends the request to the server and gets the response----------

	//sends the request via https and writes it into $response. timeout is set to 0
	$response = $client->send($request,0,'https');

	//generates a storable representation of $response and writes it into $result_xml
	//$result_xml = $response->serialize();

	//checks the response. if the method "faultCode" returns zero, the response was succesfull
	if (0==$response->faultCode())
		//returns the value sent by the server
		$value = $response->value();

		//returns the actual PHP-language value of "value"
		$result_obj = $value->scalarval();

		//destroys "value"
		//returns the faultCode and the faultString
		return $error = array ( 'faultCode' => $response->faultCode(), 'faultString' => $response->faultString());

	//destroys "client"

	//destroys "response"

	//----------reads the result_obj----------
	//if result_obj is set then it returns the actual PHP-language value of "result_obj"
	if (isset($result_obj['status']))
		$value['status'] = $result_obj['status']->scalarval();
	if (isset($result_obj['srv_main_ipv6']))
		$value['srv_main_ipv6'] = $result_obj['srv_main_ipv6']->scalarval();

	return $value;

//calls the function
$result = server_ipv6addr_set_main($host, $port, $username, $password, $api_path, $srv_id);
	echo "Status: ".$result['status']."<br>";
	echo "Server main IPv6 address: ".$result['srv_main_ipv6'];
	echo "faultCode: ".$result['faultCode']." faultString: ".$result['faultString'];