PHP Client Application

The following code sample presents ready-to-use client application written in PHP.

Note: If you want to use this sample make sure you have PHP 4.0.2 or later.
For more information, visit or



class ApiRequestException

Extends the standard Exception class. Visit for details.

function domainsInfoRequest()

Uses the DOM model to compose a request XML packet. Returns the resulting DOM object.

function curlInit()

Initializes the CURL session with necessary options as follows:


specifies the destination URL


set to true means that the resulting output will be returned from the server in the form of a string.


set to true means that the packet will be sent via HTTP POST.


set to false stops CURL from verifying the peer's certificate.


set to false stops CURL from verifying the host.


specifies an array of HTTP header fields to set.

Returns the handler of the URL session.

function sendRequest()

Sends the HTTP packet by means of CURL and gets the pure XML response packet (without the HTTP header). Closes the CURL session and returns the resulting packet (a plain text with XML tags). To learn more about the CURL engine, visit

function parseResponse()

Gets the response packet (plain text) as a parameter. Parses the packet using SimpleXML and returns the SimpleXMLElement object in which the packet is structured as a tree. To learn more about the SimpleXML extension of PHP, visit

function checkResponse()

Gets the response packet of type SimpleXMLEelement and checks the result node. If this node holds 'error', then the function throws an exception with a string passed in the errtext node.


The main() function invokes these functions in the order they are considered. First it calls domainInfoRequest() to form a packet as follows:

<?xml version="1.0" encoding="UTF-8" ?>
<packet version="">


Then curlInit() is called to initialize CURL session with options. The sendRequest function sends a packet with the HTTP header as follows:

POST /enterprise/control/agent.php HTTP/1.1
Content-Length: 294
Content-Type: text/xml


The response XML packet received from Plesk server can look as follows:

<?xml version="1.0" encoding="UTF-8" ?>
<packet version="">


Once the response packet is received and parsed with the parseResponse() function, the foreach iterator echoes the contents of the result node.


Code sample

 * Reports error during API RPC request
class ApiRequestException extends Exception {}
 * Returns DOM object representing request for information about all available domains
 * @return DOMDocument
function domainsInfoRequest()
      $xmldoc = new DomDocument('1.0', 'UTF-8');
      $xmldoc->formatOutput = true;
      // <packet>
      $packet = $xmldoc->createElement('packet');
      $packet->setAttribute('version', '');
      // <packet/domain>
      $domain = $xmldoc->createElement('domain');
      // <packet/domain/get>
      $get = $xmldoc->createElement('get');
      // <packet/domain/get/filter>
      $filter = $xmldoc->createElement('filter');
      // <packet/domain/get/dataset>
      $dataset = $xmldoc->createElement('dataset');
      // dataset elements
      return $xmldoc;

 * Prepares CURL to perform Plesk API request
 * @return resource
function curlInit($host, $login, $password)
      $curl = curl_init();
      curl_setopt($curl, CURLOPT_URL, "https://{$host}:8443/enterprise/control/agent.php");
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($curl, CURLOPT_POST,           true);
      curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
      curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
      curl_setopt($curl, CURLOPT_HTTPHEADER,
             array("HTTP_AUTH_LOGIN: {$login}",
                    "HTTP_AUTH_PASSWD: {$password}",
                    "HTTP_PRETTY_PRINT: TRUE",
                    "Content-Type: text/xml")
      return $curl;

 * Performs a Plesk API request, returns raw API response text
 * @return string
 * @throws ApiRequestException
function sendRequest($curl, $packet)
      curl_setopt($curl, CURLOPT_POSTFIELDS, $packet);
      $result = curl_exec($curl);
      if (curl_errno($curl)) {
             $errmsg  = curl_error($curl);
             $errcode = curl_errno($curl);
             throw new ApiRequestException($errmsg, $errcode);
      return $result;
 * Looks if API responded with correct data
 * @return SimpleXMLElement
 * @throws ApiRequestException
function parseResponse($response_string)
      $xml = new SimpleXMLElement($response_string);
      if (!is_a($xml, 'SimpleXMLElement'))
             throw new ApiRequestException("Cannot parse server response: {$response_string}");
      return $xml;

 * Check data in API response
 * @return void
 * @throws ApiRequestException
function checkResponse(SimpleXMLElement $response)
      $resultNode = $response->domain->get->result;
      // check if request was successful
      if ('error' == (string)$resultNode->status)
             throw new ApiRequestException("Plesk API returned error: " . (string)$resultNode->result->errtext);
// int main()
$host = '';
$login = 'admin';
$password = 'qwedsa';
$curl = curlInit($host, $login, $password);
try {
      $response = sendRequest($curl, domainsInfoRequest()->saveXML());
      $responseXml = parseResponse($response);
} catch (ApiRequestException $e) {
      echo $e;
// Explore the result
foreach ($responseXml->xpath('/packet/domain/get/result') as $resultNode) {
      echo "Domain id: " . (string)$resultNode->id . " ";
      echo (string)$resultNode->data->gen_info->name . " (" . (string)$resultNode->data->gen_info->dns_ip_address . ")\n";