add kerio php api

api/KerioConnectApi.php

@@ -0,0 +1,116 @@
+<?php
+/**
+ * This file is part of the kerio-api-php.
+ *
+ * Copyright (c) Kerio Technologies s.r.o.
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code
+ * or visit Developer Zone. (http://www.kerio.com/developers)
+ *
+ * Do not modify this source code.
+ * Any changes may be overwritten by a new version.
+ */
+
+require_once(dirname(__FILE__) . '/class/KerioApi.php');
+
+/**
+ * Administration API for Kerio Connect.
+ *
+ * This class implements product-specific methods and properties.
+ *
+ * Example:
+ * <code>
+ * <?php
+ * require_once(dirname(__FILE__) . '/src/KerioConnectApi.php');
+ *
+ * $api = new KerioConnectApi('Sample application', 'Company Ltd.', '1.0');
+ *
+ * try {
+ *     $api->login('mail.company.tld', 'admin', 'SecretPassword');
+ *     $api->sendRequest('...');
+ *     $api->logout();
+ * } catch (KerioApiException $error) {
+ *     print $error->getMessage();
+ * }
+ * ?>
+ * </code>
+ *
+ * @copyright	Copyright &copy; 2012-2012 Kerio Technologies s.r.o.
+ * @license		http://www.kerio.com/developers/license/sdk-agreement
+ * @version		1.4.0.234
+ */
+class KerioConnectApi extends KerioApi {
+
+	/**
+	 * Defines default product-specific JSON-RPC settings.
+	 * @var array
+	 */
+	protected $jsonRpc = array(
+		'version'	=> '2.0',
+		'port'		=> 4040,
+		'api'		=> '/admin/api/jsonrpc/'
+	);
+
+	/**
+	 * Class constructor.
+	 *
+	 * @param	string	Application name
+	 * @param	string	Application vendor
+	 * @param	string	Application version
+	 * @return	void
+	 * @throws	KerioApiException
+	 */
+	public function __construct($name, $vendor, $version) {
+		parent::__construct($name, $vendor, $version);
+	}
+
+	/**
+	 * Set component Web Administration.
+	 * 
+	 * @param	void
+	 * @return	void
+	 */
+	public function setComponentAdmin() {
+		$this->setJsonRpc('2.0', 4040, '/admin/api/jsonrpc/');
+	}
+
+	/**
+	 * Set component Client aka WebMail.
+	 * 
+	 * @param	void
+	 * @return	void
+	 */
+	public function setComponentClient() {
+		$this->setJsonRpc('2.0', 443, '/webmail/api/jsonrpc/');
+	}
+
+	/**
+	 * Set component WebMail.
+	 * 
+	 * @param	void
+	 * @return	void
+	 * @deprecated
+	 */
+	public function setComponentWebmail() {
+		trigger_error("Deprecated function setComponentMyphone(), use setComponentClient() instead", E_USER_NOTICE);
+		$this->setComponentClient();
+	}
+
+	/**
+	 * Get constants defined by product.
+	 *
+	 * @param	void
+	 * @return	array	Array of constants
+	 */
+	public function getConstants() {
+		$response = $this->sendRequest('Server.getNamedConstantList');
+		$constantList = array();
+
+		foreach ($response['constants'] as $index) {
+			$constantList[$index['name']] = $index['value'];
+		}
+
+		return $constantList;
+	}
+}

api/KerioControlApi.php

@@ -0,0 +1,83 @@
+<?php
+/**
+ * This file is part of the kerio-api-php.
+ *
+ * Copyright (c) Kerio Technologies s.r.o.
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code
+ * or visit Developer Zone. (http://www.kerio.com/developers)
+ *
+ * Do not modify this source code.
+ * Any changes may be overwritten by a new version.
+ */
+
+require_once(dirname(__FILE__) . '/class/KerioApi.php');
+
+/**
+ * Administration API for Kerio Control.
+ * STATUS: In progress, might change in the future
+ *
+ * This class implements product-specific methods and properties and currently is under development.
+ * Class is not intended for stable use yet.
+ * Functionality might not be fully verified, documented, or even supported.
+ *
+ * Please note that changes can be made without further notice.
+ *
+ * Example:
+ * <code>
+ * <?php
+ * require_once(dirname(__FILE__) . '/src/KerioControlApi.php');
+ *
+ * $api = new KerioControlApi('Sample application', 'Company Ltd.', '1.0');
+ *
+ * try {
+ *     $api->login('firewall.company.tld', 'admin', 'SecretPassword');
+ *     $api->sendRequest('...');
+ *     $api->logout();
+ * } catch (KerioApiException $error) {
+ *     print $error->getMessage();
+ * }
+ * ?>
+ * </code>
+ *
+ * @copyright	Copyright &copy; 2012-2012 Kerio Technologies s.r.o.
+ * @license		http://www.kerio.com/developers/license/sdk-agreement
+ * @version		1.4.0.234
+ */
+class KerioControlApi extends KerioApi {
+
+	/**
+	 * Defines product-specific JSON-RPC settings
+	 * @var array
+	 */
+	protected $jsonRpc = array(
+		'version'	=> '2.0',
+		'port'		=> 4081,
+		'api'		=> '/admin/api/jsonrpc/'
+	);
+
+	/**
+	 * Class constructor.
+	 *
+	 * @param	string	Application name
+	 * @param	string	Application vendor
+	 * @param	string	Application version
+	 * @return	void
+	 * @throws	KerioApiException
+	 */
+	public function __construct($name, $vendor, $version) {
+		parent::__construct($name, $vendor, $version);
+	}
+
+	/**
+	 * Get constants defined by product.
+	 *
+	 * @param	void
+	 * @return	array	Array of constants
+	 */
+	public function getConstants() {
+		$response = $this->sendRequest('Server.getNamedConstantList');
+		return $response['constants'];
+	}
+}

api/KerioDirectoryApi.php

@@ -0,0 +1,83 @@
+<?php
+/**
+ * This file is part of the kerio-api-php.
+ *
+ * Copyright (c) Kerio Technologies s.r.o.
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code
+ * or visit Developer Zone. (http://www.kerio.com/developers)
+ *
+ * Do not modify this source code.
+ * Any changes may be overwritten by a new version.
+ */
+
+require_once(dirname(__FILE__) . '/class/KerioApi.php');
+
+/**
+ * Administration API for Kerio Directory.
+ * STATUS: In progress, might change in the future
+ *
+ * This class implements product-specific methods and properties and currently is under development.
+ * Class is not intended for stable use yet.
+ * Functionality might not be fully verified, documented, or even supported.
+ *
+ * Please note that changes can be made without further notice.
+ *
+ * Example:
+ * <code>
+ * <?php
+ * require_once(dirname(__FILE__) . '/src/KerioDirectory.php');
+ *
+ * $api = new KerioDirectory('Sample application', 'Company Ltd.', '1.0');
+ *
+ * try {
+ *     $api->login('directory.company.tld', 'admin', 'SecretPassword');
+ *     $api->sendRequest('...');
+ *     $api->logout();
+ * } catch (KerioApiException $error) {
+ *     print $error->getMessage();
+ * }
+ * ?>
+ * </code>
+ *
+ * @copyright	Copyright &copy; 2012-2012 Kerio Technologies s.r.o.
+ * @license		http://www.kerio.com/developers/license/sdk-agreement
+ * @version		1.4.0.234
+ */
+class KerioDirectoryApi extends KerioApi {
+
+	/**
+	 * Defines product-specific JSON-RPC settings
+	 * @var array
+	 */
+	protected $jsonRpc = array(
+		'version'	=> '2.0',
+		'port'		=> 4101,
+		'api'		=> '/admin/jsonrpc/'
+	);
+
+	/**
+	 * Class constructor.
+	 *
+	 * @param	string	Application name
+	 * @param	string	Application vendor
+	 * @param	string	Application version
+	 * @return	void
+	 * @throws	KerioApiException
+	 */
+	public function __construct($name, $vendor, $version) {
+		parent::__construct($name, $vendor, $version);
+	}
+
+	/**
+	 * Get constants defined by product.
+	 *
+	 * @param	void
+	 * @return	array	Array of constants
+	 */
+	public function getConstants() {
+		$response = $this->sendRequest('Server.getInfo');
+		return $response['serverInfo'];
+	}
+}

api/KerioOperatorApi.php

@@ -0,0 +1,115 @@
+<?php
+/**
+ * This file is part of the kerio-api-php.
+ *
+ * Copyright (c) Kerio Technologies s.r.o.
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code
+ * or visit Developer Zone. (http://www.kerio.com/developers)
+ *
+ * Do not modify this source code.
+ * Any changes may be overwritten by a new version.
+ */
+
+require_once(dirname(__FILE__) . '/class/KerioApi.php');
+
+/**
+ * Administration API for Kerio Operator.
+ * STATUS: In progress, might change in the future
+ *
+ * This class implements product-specific methods and properties and currently is under development.
+ * Class is not intended for stable use yet.
+ * Functionality might not be fully verified, documented, or even supported.
+ *
+ * Please note that changes can be made without further notice.
+ *
+ * Example:
+ * <code>
+ * <?php
+ * require_once(dirname(__FILE__) . '/src/KerioOperatorApi.php');
+ *
+ * $api = new KerioOperatorApi('Sample application', 'Company Ltd.', '1.0');
+ *
+ * try {
+ *     $api->login('operator.company.tld', 'admin', 'SecretPassword');
+ *     $api->sendRequest('...');
+ *     $api->logout();
+ * } catch (KerioApiException $error) {
+ *     print $error->getMessage();
+ * }
+ * ?>
+ * </code>
+ *
+ * @copyright	Copyright &copy; 2012-2012 Kerio Technologies s.r.o.
+ * @license		http://www.kerio.com/developers/license/sdk-agreement
+ * @version		1.4.0.234
+ */
+class KerioOperatorApi extends KerioApi {
+
+	/**
+	 * Defines default product-specific JSON-RPC settings
+	 * @var array
+	 */
+	protected $jsonRpc = array(
+		'version'	=> '2.0',
+		'port'		=> 4021,
+		'api'		=> '/admin/api/jsonrpc/'
+	);
+
+	/**
+	 * Class constructor.
+	 *
+	 * @param	string	Application name
+	 * @param	string	Application vendor
+	 * @param	string	Application version
+	 * @return	void
+	 * @throws	KerioApiException
+	 */
+	public function __construct($name, $vendor, $version) {
+		parent::__construct($name, $vendor, $version);
+	}
+
+	/**
+	 * Set component Web Administration.
+	 * 
+	 * @param	void
+	 * @return	void
+	 */
+	public function setComponentAdmin() {
+		$this->setJsonRpc('2.0', 4021, '/admin/api/jsonrpc/');
+	}
+
+	/**
+	 * Set component Client aka MyPhone.
+	 * 
+	 * @param	void
+	 * @return	void
+	 */
+	public function setComponentClient() {
+		$this->setJsonRpc('2.0', 443, '/myphone/api/jsonrpc/');
+	}
+
+	/**
+	 * Set component MyPhone.
+	 * 
+	 * @param	void
+	 * @return	void
+	 * @deprecated
+	 */
+	public function setComponentMyphone() {
+		trigger_error("Deprecated function setComponentMyphone(), use setComponentClient() instead", E_USER_NOTICE);
+		$this->setComponentClient();
+	}
+
+	/**
+	 * Get constants defined by product.
+	 *
+	 * @param	void
+	 * @return	array	Array of constants
+	 */
+	public function getConstants() {
+		$response = $this->sendRequest('Server.getConstantList');
+		return $response['constantList'];
+	}
+}

api/KerioWorkspaceApi.php

@@ -0,0 +1,146 @@
+<?php
+/**
+ * This file is part of the kerio-api-php.
+ *
+ * Copyright (c) Kerio Technologies s.r.o.
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code
+ * or visit Developer Zone. (http://www.kerio.com/developers)
+ *
+ * Do not modify this source code.
+ * Any changes may be overwritten by a new version.
+ */
+
+require_once(dirname(__FILE__) . '/class/KerioApi.php');
+
+/**
+ * Administration API for Kerio Workspace.
+ * STATUS: In progress, might change in the future
+ *
+ * This class implements product-specific methods and properties and currently is under development.
+ * Class is not intended for stable use yet.
+ * Functionality might not be fully verified, documented, or even supported.
+ *
+ * Please note that changes can be made without further notice.
+ *
+ * Example:
+ * <code>
+ * <?php
+ * require_once(dirname(__FILE__) . '/src/KerioWorkspaceApi.php');
+ *
+ * $api = new KerioWorkspaceApi('Sample application', 'Company Ltd.', '1.0');
+ *
+ * try {
+ *     $api->login('workspace.company.tld', 'admin', 'SecretPassword');
+ *     $api->sendRequest('...');
+ *     $api->logout();
+ * } catch (KerioApiException $error) {
+ *     print $error->getMessage();
+ * }
+ * ?>
+ * </code>
+ *
+ * @copyright	Copyright &copy; 2012-2012 Kerio Technologies s.r.o.
+ * @license		http://www.kerio.com/developers/license/sdk-agreement
+ * @version		1.4.0.234
+ */
+class KerioWorkspaceApi extends KerioApi {
+
+	/**
+	 * Defines default product-specific JSON-RPC settings
+	 * @var array
+	 */
+	protected $jsonRpc = array(
+		'version'	=> '2.0',
+		'port'		=> 4060,
+		'api'		=> '/admin/api/jsonrpc/'
+	);
+	
+	private $file = array();
+
+	/**
+	 * Class constructor.
+	 *
+	 * @param	string	Application name
+	 * @param	string	Application vendor
+	 * @param	string	Application version
+	 * @return	void
+	 * @throws	KerioApiException
+	 */
+	public function __construct($name, $vendor, $version) {
+		parent::__construct($name, $vendor, $version);
+	}
+
+	/**
+	 * Set component Web Administration.
+	 * 
+	 * @param	void
+	 * @return	void
+	 */
+	public function setComponentAdmin() {
+		$this->setJsonRpc('2.0', 4060, '/admin/api/jsonrpc/');
+	}
+
+	/**
+	 * Set component Workspace Client.
+	 * 
+	 * @param	void
+	 * @return	void
+	 */
+	public function setComponentClient() {
+		$this->setJsonRpc('2.0', 443, '/server/data');
+	}
+
+	/**
+	 * Get constants defined by product.
+	 *
+	 * @param	void
+	 * @return	array	Array of constants
+	 */
+	public function getConstants() {
+		$response = $this->sendRequest('Server.getProductInfo');
+		return $response['constants'];
+	}
+
+	/**
+	 * Get headers for PUT request.
+	 *
+	 * @param	string	Request body
+	 * @return	string	Request body
+	 */
+	protected function getHttpPutRequest($data) {
+		$this->headers['POST']			= sprintf('%s?method=PutFile&filename=%s&parentId=%d&lenght=%d HTTP/1.1', $this->jsonRpc['api'], rawurlencode($this->file['filename']), $this->file['parentId'], $this->file['lenght']);
+		$this->headers['Accept:']		= '*/*';
+		$this->headers['Content-Type:']	= sprintf('application/k-upload');
+	
+		return $data;
+	}
+	
+	/**
+	 * Put a file to server.
+	 *
+	 * @param	string	Absolute path to file
+	 * @param	integer	Reference ID where uploaded file belongs to
+	 * @return	array	Result
+	 * @throws	KerioApiException
+	 */
+	public function uploadFile($filename, $id = null) {
+		$data = @file_get_contents($filename);
+		
+		$this->file['filename'] = basename($filename);
+		$this->file['parentId'] = $id;
+		$this->file['lenght']	= strlen($data);
+	
+		if ($data) {
+			$this->debug(sprintf('Uploading file %s to item %d', $filename, $id));
+			$json_response = $this->send('PUT', $data);
+		}
+		else {
+			throw new KerioApiException(sprintf('Unable to open file %s', $filename));
+		}
+	
+		$response = json_decode($json_response, TRUE);
+		return $response['result'];
+	}
+}

api/SamepageApi.php

@@ -0,0 +1,170 @@
+<?php
+/**
+ * This file is part of the kerio-api-php.
+ *
+ * Copyright (c) Kerio Technologies s.r.o.
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code
+ * or visit Developer Zone. (http://www.kerio.com/developers)
+ *
+ * Do not modify this source code.
+ * Any changes may be overwritten by a new version.
+ */
+
+require_once(dirname(__FILE__) . '/class/KerioApi.php');
+
+/**
+ * Samepage.io.
+ * STATUS: In progress, might change in the future
+ *
+ * This class implements product-specific methods and properties and currently is under development.
+ * Class is not intended for stable use yet.
+ * Functionality might not be fully verified, documented, or even supported.
+ *
+ * Please note that changes can be made without further notice.
+ *
+ * Example:
+ * <code>
+ * <?php
+ * require_once(dirname(__FILE__) . '/src/KerioWorkspaceApi.php');
+ *
+ * $api = new SamepageApi('Sample Application', 'Company Ltd.', '1.0');
+ *
+ * try {
+ *     $api->login('samepage.io', 'user@company.tld', 'SecretPassword');
+ *     $api->sendRequest('...');
+ *     $api->logout();
+ * } catch (KerioApiException $error) {
+ *     print $error->getMessage();
+ * }
+ * ?>
+ * </code>
+ *
+ * @copyright	Copyright &copy; 2012-2012 Kerio Technologies s.r.o.
+ * @license		http://www.kerio.com/developers/license/sdk-agreement
+ * @version		1.4.0.234
+ */
+class SamepageApi extends KerioApi {
+
+	/**
+	 * Defines default product-specific JSON-RPC settings
+	 * @var array
+	 */
+	protected $jsonRpc = array(
+		'version'	=> '2.0',
+		'port'		=> 443,
+		'api'		=> '/server/data'
+	);
+	
+	/**
+	 * File info, for upload
+	 * @var	array
+	 */
+	private $file = array();
+
+	/**
+	 * Tenant info
+	 * @var	string
+	 */
+	private $tenant = '';
+	
+	private $endpoint = '';
+
+	/**
+	 * Class constructor.
+	 *
+	 * @param	string	Application name
+	 * @param	string	Application vendor
+	 * @param	string	Application version
+	 * @return	void
+	 * @throws	KerioApiException
+	 */
+	public function __construct($name, $vendor, $version) {
+		parent::__construct($name, $vendor, $version);
+	}
+
+	/**
+	 * @see class/KerioApi::login()
+	 */
+	public function login($hostname, $username, $password) {
+		$this->application = 'CLIENT';
+		$response = parent::login($hostname, $username, $password);
+		if ($response['tenant']) {
+			$this->setTenant($response['tenant']);
+		}
+		return $response;
+	}
+	
+	/**
+	 * @see class/KerioApi::logout()
+	 */
+	public function logout() {
+		$response = parent::logout();
+		$this->jsonRpc['api'] = '/server/data';
+	}
+
+	/**
+	 * Get tenant.
+	 * 
+	 * @param	void
+	 * @return	string
+	 */
+	public function getTenant() {
+		return $this->tenant;
+	}
+
+        /**
+         * Set tenant.
+         * 
+         * @param   string
+         * @return  void
+         */
+        public function setTenant($tenantId) {
+            $this->tenant = $tenantId;
+            $this->jsonRpc['api'] = sprintf('/%s%s', $this->tenant, '/server/data');
+        }
+        
+	/**
+	 * Get headers for PUT request.
+	 *
+	 * @param	string	Request body
+	 * @return	string	Request body
+	 */
+	protected function getHttpPutRequest($data) {
+		$this->headers['POST']			= sprintf('%s&filename=%s&parentId=%d&lenght=%d HTTP/1.1', $this->endpoint, rawurlencode($this->file['filename']), $this->file['parentId'], $this->file['lenght']);
+		$this->headers['Accept:']		= '*/*';
+		$this->headers['Content-Type:']	= sprintf('application/k-upload');
+	
+		return $data;
+	}
+	
+	/**
+	 * Put a file to server.
+	 *
+	 * @param	string	Absolute path to file
+	 * @param	integer	Reference ID where uploaded file belongs to
+	 * @return	array	Result
+	 * @throws	KerioApiException
+	 */
+	public function uploadFile($filename, $id = null) {
+		$data = @file_get_contents($filename);
+
+		$this->endpoint = sprintf('%s?method=Files.create', $this->jsonRpc['api']);
+
+		$this->file['filename'] = basename($filename);
+		$this->file['parentId'] = $id;
+		$this->file['lenght']	= strlen($data);
+	
+		if ($data) {
+			$this->debug(sprintf('Uploading file %s to item %d', $filename, $id));
+			$json_response = $this->send('PUT', $data);
+		}
+		else {
+			throw new KerioApiException(sprintf('Unable to open file %s', $filename));
+		}
+	
+		$response = json_decode($json_response, TRUE);
+		return $response['result'];
+	}
+}

api/class/KerioApi.php

@@ -0,0 +1,732 @@
+<?php
+/**
+ * This file is part of the kerio-api-php.
+ *
+ * Copyright (c) Kerio Technologies s.r.o.
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code
+ * or visit Developer Zone. (http://www.kerio.com/developers)
+ *
+ * Do not modify this source code.
+ * Any changes may be overwritten by a new version.
+ */
+
+require_once(dirname(__FILE__) . '/KerioApiInterface.php');
+require_once(dirname(__FILE__) . '/KerioApiSocket.php');
+require_once(dirname(__FILE__) . '/KerioApiException.php');
+
+/**
+ * Kerio API Class.
+ *
+ * This is main class.
+ *
+ * Example:
+ * <code>
+ * <?php
+ * require_once(dirname(__FILE__) . '/src/KerioApi.php');
+ *
+ * class MyApi extents KerioApi {
+ *
+ *     public function __contruct($name, $vendor, $version) {
+ *         parent::__construct($name, $vendor, $version);
+ *     }
+ *
+ *     public function getFoo() {
+ *         return $this->sendRequest('...');
+ *     }
+ * }
+ * ?>
+ * </code>
+ *
+ * @copyright	Copyright &copy; 2012-2012 Kerio Technologies s.r.o.
+ * @license		http://www.kerio.com/developers/license/sdk-agreement
+ * @version		1.4.0.234
+ */
+class KerioApi implements KerioApiInterface {
+
+	/**
+	 * End-Line format
+	 */
+	const CRLF = "\r\n";
+
+	/**
+	 * HTTP server status
+	 */
+	const HTTP_SERVER_OK = 200;
+
+	/**
+	 * Library name
+	 * @var	string
+	 */
+	public $name = 'Kerio APIs Client Library for PHP';
+
+	/**
+	 * Library version
+	 * @var string
+	 */
+	public $version = '1.4.0.234';
+
+	/**
+	 * Debug mode
+	 * @var	boolean
+	 */
+	private $debug = FALSE;
+
+	/**
+	 * Unique id used in request
+	 * @var	integer
+	 */
+	private $requestId = 0;
+
+	/**
+	 * Hostname
+	 * @var string
+	 */
+	protected $hostname = '';
+
+	/**
+	 * X-Token
+	 * @var	string
+	 */
+	protected $token = '';
+
+	/**
+	 * Cookies
+	 * @var	string
+	 */
+	protected $cookies = '';
+
+	/**
+	 * Application details
+	 * @var	array
+	 */
+	protected $application = array('name' => '', 'vendor' => '', 'version' => '');
+
+	/**
+	 * JSON-RPC settings
+	 * @var	array
+	 */
+	protected $jsonRpc = array('version' => '', 'port' => '', 'api' => '');
+
+	/**
+	 * HTTP headers
+	 * @var	array
+	 */
+	protected $headers = array();
+
+	/**
+	 * Socket handler
+	 * @var	resource
+	 */
+	private $socketHandler = '';
+
+	/**
+	 * Socket timeout
+	 * @var	integer
+	 */
+	private $timeout = '';
+
+	/**
+	 * Class contructor.
+	 *
+	 * @param	string	Application name
+	 * @param	string	Application vendor
+	 * @param	string	Application version
+	 * @return	void
+	 * @throws	KerioApiException
+	 */
+	public function __construct($name, $vendor, $version) {
+		$this->checkPhpEnvironment();
+		$this->setApplication($name, $vendor, $version);
+		$this->setJsonRpc($this->jsonRpc['version'], $this->jsonRpc['port'], $this->jsonRpc['api']);
+	}
+
+	/**
+	 * Check PHP environment.
+	 *
+	 *  @param	void
+	 *  @return	void
+	 */
+	private function checkPhpEnvironment() {
+		if (version_compare(PHP_VERSION, '5.1.0', '<')) {
+			die(sprintf('<h1>kerio-api-php error</h1>Minimum PHP version required is 5.1.0. Your installation is %s.<br>Please, upgrade your PHP installation.', phpversion()));
+		}
+		if (FALSE === function_exists('openssl_open')) {
+			die('<h1>kerio-api-php error</h1>Your PHP installation does not have OpenSSL enabled.<br>To configure OpenSSL support in PHP, please edit your php.ini config file and enable row with php_openssl module, e.g. extension=php_openssl.dll<br>For more information see <a href="http://www.php.net/manual/en/openssl.installation.php">http://www.php.net/manual/en/openssl.installation.php</a>.');
+		}
+		if (FALSE === function_exists('json_decode')) {
+			die('<h1>kerio-api-php error</h1>Your PHP installation does not have JSON enabled.<br>To configure JSON support in PHP, please edit your php.ini config file and enable row with php_json module, e.g. extension=php_json.dll<br>For more information see <a href="http://www.php.net/manual/en/json.installation.php">http://www.php.net/manual/en/json.installation.php</a>.');
+		}
+	}
+
+	/**
+	 * Set application to identify on server.
+	 *
+	 * @param	string	Application name
+	 * @param	string	Vendor
+	 * @param	string	Version
+	 * @return	void
+	 * @throws	KerioApiException
+	 */
+	private function setApplication($name, $vendor, $version) {
+		if (empty($name) && empty($vendor) && empty($version)) {
+			throw new KerioApiException('Application not defined.');
+		}
+		else {
+			$this->debug(sprintf("Registering application '%s' by '%s' version '%s'<br>", $name, $vendor, $version));
+			$this->application = array(
+				'name'		=> $name,
+				'vendor'	=> $vendor,
+				'version'	=> $version
+			);
+		}
+	}
+
+	/**
+	 * Get application detail.
+	 *
+	 * @param	void
+	 * @return	array	Application details
+	 */
+	public final function getApplication() {
+		return $this->application;
+	}
+
+	/**
+	 * Set JSON-RPC settings.
+	 *
+	 * @see class/KerioApiInterface::setJsonRpc()
+	 * @param	string	JSON-RPC version
+	 * @param	integer	JSON-RPC port
+	 * @param	string	JSON-RPC URI
+	 * @return	void
+	 * @throws	KerioApiException
+	 */
+	public final function setJsonRpc($version, $port, $api) {
+		if (empty($version) && empty($port) && empty($api)) {
+			throw new KerioApiException('JSON-RPC not defined.');
+		}
+		else {
+			$this->debug(sprintf("Registering JSON-RPC %s on %s using port %d", $version, $api, $port));
+			$this->jsonRpc = array(
+				'version'	=> $version,
+				'port'		=> $port,
+				'api'		=> $api
+			);
+		}
+	}
+
+	/**
+	 * Get JSON-RPC settings.
+	 *
+	 * @param	void
+	 * @return	array	JSON-RPC settings
+	 */
+	public final function getJsonRpc() {
+		return $this->jsonRpc;
+	}
+
+	/**
+	 * Enable or disable of displaying debug messages.
+	 *
+	 * @param	boolean
+	 * @return	void
+	 */
+	public final function setDebug($boolean) {
+		$this->debug = (bool) $boolean;
+	}
+
+	/**
+	 * Get debug settings.
+	 *
+	 * @param	void
+	 * @return	boolean
+	 */
+	public final function getDebug() {
+		return $this->debug;
+	}
+
+	/**
+	 * Display a message if debug is TRUE.
+	 *
+	 * @param 	string	Message
+	 * @param	string	CSS class
+	 * @return	string	Message in &lt;div&gt; tags
+	 */
+	public function debug($message, $css = 'debug') {
+		if ($this->debug) {
+			printf('<div class="%s">%s</div>%s', $css, $message, "\n");
+		}
+	}
+
+	/**
+	 * Get product API version.
+	 *
+	 * @param	void
+	 * @return	integer	API version
+	 */
+	public function getApiVersion() {
+		$method = 'Version.getApiVersion';
+		$response = $this->sendRequest($method);
+		return $response['apiVersion'];		
+	}
+
+	/**
+	 * Login method.
+	 *
+	 * @see class/KerioApiInterface::login()
+	 * @param	string	Hostname
+	 * @param	string	Username
+	 * @param	string	Password
+	 * @return	array	Result
+	 * @throws	KerioApiException
+	 */
+	public function login($hostname, $username, $password) {
+		$this->clean();
+
+		if (empty($hostname)) {
+			throw new KerioApiException('Cannot login. Hostname not set.');
+		}
+		elseif (empty($username)) {
+			throw new KerioApiException('Cannot login. Username not set.');
+		}
+		elseif (empty($this->application)) {
+			throw new KerioApiException('Cannot login. Application not defined.');
+		}
+
+		$this->setHostname($hostname);
+
+		$method = 'Session.login';
+		$params = array(
+			'userName'		=> $username,
+			'password'		=> $password,
+			'application'	=> $this->application
+		);
+
+		$response = $this->sendRequest($method, $params);
+		return $response;
+	}
+
+	/**
+	 * Logout method.
+	 *
+	 * @see class/KerioApiInterface::logout()
+	 * @param	void
+	 * @return	array	Result
+	 */
+	public function logout() {
+		$method = 'Session.logout';
+		$response = $this->sendRequest($method);
+		$this->clean();
+		return $response;
+	}
+
+	/**
+	 * Clean data.
+	 *
+	 * @param	void
+	 * @return	void
+	 */
+	public function clean() {
+		if ($this->token) {
+			$this->debug('Removing X-Token.');
+			$this->token = '';
+		}
+		if ($this->cookies) {
+			$this->debug('Removing Cookies.');
+			$this->cookies = '';
+		}
+		$this->hostname = '';
+		$this->socketHandler = '';
+	}
+
+	/**
+	 * Get full HTTP request.
+	 *
+	 * @param	string	HTTP method [POST,GET,PUT]
+	 * @param	string	HTTP body
+	 * @return	string	HTTP request
+	 * @throws	KerioApiException
+	 */
+	protected function getHttpRequest($method, $body) {
+		/* Clean data */
+		$this->headers = array();
+		$bodyRequest = '';
+		$fullRequest = '';
+
+		/* Prepare headers and get request body*/
+		switch ($method) {
+			case 'POST': // common requests
+				$bodyRequest = $this->getHttpPostRequest($body);
+				break;
+			case 'GET': // download
+				$bodyRequest = $this->getHttpGetRequest($body);
+				break;
+			case 'PUT': // upload
+				$bodyRequest = $this->getHttpPutRequest($body);
+				break;
+			default:
+				throw new KerioApiException('Cannot send request, unknown method.');
+		}
+
+		/* Add port to headers if non-default is used */
+		$port = ($this->jsonRpc['port'] == 443)
+			? ''
+			: sprintf(':%d', $this->jsonRpc['port']);
+
+		/* Set common headers */
+		$this->headers['Host:']				= sprintf('%s%s', $this->hostname, $port);
+		$this->headers['Content-Length:']	= strlen($bodyRequest);
+		$this->headers['Connection:']		= 'close';
+
+		/* Set X-Token and Cookies */
+		if ($this->token) {
+			$this->headers['Cookie:']	= $this->cookies;
+			$this->headers['X-Token:']	= $this->token;
+		}
+
+		/* Build request */
+		foreach ($this->headers as $item => $value){
+			$fullRequest .= $item . ' ' . $value . self::CRLF;
+		}
+		$fullRequest .= self::CRLF;
+		$fullRequest .= $bodyRequest;
+
+		/* Return */
+		return $fullRequest;
+	}
+
+	/**
+	 * Get headers for POST request.
+	 *
+	 * @param	string	Request body
+	 * @return	string	Request body
+	 */
+	protected function getHttpPostRequest($data) {
+		$this->headers['POST']			= sprintf('%s HTTP/1.1', $this->jsonRpc['api']);
+		$this->headers['Accept:']		= 'application/json-rpc';
+		$this->headers['Content-Type:']	= 'application/json-rpc; charset=UTF-8';
+		$this->headers['User-Agent:']	= sprintf('%s/%s', $this->name, $this->version);
+
+		return str_replace(array("\r", "\r\n", "\n", "\t"), '', $data) . self::CRLF;
+	}
+
+	/**
+	 * Get headers for GET request.
+	 *
+	 * @param	string	Request body
+	 * @return	string	Request body
+	 */
+	protected function getHttpGetRequest($data) {
+		$this->headers['GET']				= sprintf('%s HTTP/1.1', $data);
+		$this->headers['Accept:']			= '*/*';
+
+		return $data . self::CRLF;
+	}
+
+	/**
+	 * Get headers for PUT request.
+	 *
+	 * @param	string	Request body
+	 * @return	string	Request body
+	 */
+	protected function getHttpPutRequest($data) {
+		$boundary = sprintf('---------------------%s', substr(md5(rand(0,32000)), 0, 10));
+
+		$this->headers['POST']			= sprintf('%s%s HTTP/1.1', $this->jsonRpc['api'], 'upload/');
+		$this->headers['Accept:']		= '*/*';
+		$this->headers['Content-Type:']	= sprintf('multipart/form-data; boundary=%s', $boundary);
+
+		$body = '--' . $boundary . self::CRLF;
+		$body .= 'Content-Disposition: form-data; name="unknown"; filename="newFile.bin"' . self::CRLF;
+		$body .= self::CRLF;
+		$body .= $data . self::CRLF;
+		$body .= '--' . $boundary . '--' . self::CRLF;
+
+		return $body;
+	}
+
+	/**
+	 * Send request using method and its params.
+	 *
+	 * @see class/KerioApiInterface::sendRequest()
+	 * @param	string	Interface.method
+	 * @param	array	Params of 'Interface.method'.
+	 * @return	array	Returns same type as param is, e.g. JSON if method is also JSON
+	 */
+	public function sendRequest($method, $params = '') {
+		$request = array(
+			'jsonrpc'	=>	$this->jsonRpc['version'],
+			'id'		=>	$this->getRequestId(),
+			'token'		=>	$this->token,
+			'method'	=>	$method,
+			'params'	=>	$params
+		);
+
+		if (empty($this->token)) {
+			unset($request['token']);
+		}
+		if (empty($params)) {
+			unset($request['params']);
+		}
+
+		$json_request = json_encode($request);
+
+		/* Send data to server */
+		$json_response = $this->send('POST', $json_request);
+
+		/* Return */
+		$response = json_decode($json_response, TRUE);
+		return $response['result'];
+	}
+
+	/**
+	 * Send JSON request.
+	 *
+	 * @param	string	JSON request
+	 * @return	string	JSON response
+	 */
+	public function sendRequestJson($json) {
+		return $this->send('POST', $json);
+	}
+
+	/**
+	 * Send data to server.
+	 *
+	 * @param	string	Request method [POST,GET,PUT]
+	 * @param	string	Request body
+	 * @return	string	Server response
+	 * @throws	KerioApiException
+	 */
+	protected function send($method, $data) {
+		if (empty($this->hostname)) {
+			throw new KerioApiException('Cannot send data before login.');
+		}
+
+		/* Get full HTTP request */
+		$request = $this->getHttpRequest($method, $data);
+		$this->debug(sprintf("&rarr; Raw request:\n<pre>%s</pre>", $request));
+
+		/* Open socket */
+		$this->socketHandler = new KerioApiSocket($this->hostname, $this->jsonRpc['port'], $this->timeout);
+
+		/* Send data */
+		$rawResponse = $this->socketHandler->send($request);
+		$this->debug(sprintf("&larr; Raw response:\n<pre>%s</pre>", $rawResponse));
+
+		/* Parse response */
+		$headers	= $this->socketHandler->getHeaders();
+		$body		= $this->socketHandler->getBody();
+		$this->checkHttpResponse(self::HTTP_SERVER_OK, $headers);
+
+		/* Decode JSON response */
+		$response = stripslashes($body);
+		$response = json_decode($body, TRUE);
+		if (($method == 'POST') && empty($response)) {
+			throw new KerioApiException('Invalid JSON data, cannot parse response.');
+		}
+
+		/* Set CSRF token */
+		if (empty($this->token)) {
+			if (isset($response['result']['token'])) {
+				$this->setToken($response['result']['token']);
+			}
+		}
+
+		/* Handle errors */
+		if (isset($response['error'])) {
+			if (FALSE === empty($response['error'])) {
+				$message	= $response['error']['message'];
+				$code		= $response['error']['code'];
+				$params = (isset($response['error']['data']))
+					? $response['error']['data']['messageParameters']['positionalParameters']
+					: '';
+				throw new KerioApiException($message, $code, $params, $data, $body);
+			}
+		}
+		elseif (isset($response['result']['errors'])) {
+			if (FALSE === empty($response['result']['errors'])) {
+				$message	= $response['result']['errors'][0]['message'];
+				$code		= $response['result']['errors'][0]['code'];
+				$params		= $response['result']['errors'][0]['messageParameters']['positionalParameters'];
+				throw new KerioApiException($message, $code, $params, $data, $body);
+			}
+		}
+
+		/* Handle Cookies */
+		if (empty($this->cookies)) {
+			$this->setCookieFromHeaders($headers);
+		}
+
+		/* Return */
+		return $body;
+	}
+
+	/**
+	 * Get a file from server.
+	 *
+	 * @param	string	File url
+	 * @param	string	Save directory
+	 * @param	string	Save as, optional. Default is file.bin
+	 * @return	boolean	True on success
+	 * @throws	KerioApiException
+	 */
+	public function downloadFile($url, $directory, $filename = '') {
+		$saveAs = (empty($filename)) ? 'file.bin' : $filename;
+		$saveAs = sprintf('%s/%s', $directory, $filename);
+
+		$data = $this->send('GET', $url);
+
+		$this->debug(sprintf('Saving file %s', $saveAs));
+		if (FALSE === @file_put_contents($saveAs, $data)) {
+			throw new KerioApiException(sprintf('Unable to save file %s', $saveAs));
+		}
+		return TRUE;
+	}
+	
+	/**
+	 * Get a file from server.
+	 *
+	 * @param	string	File url
+	 * @return	string	File content
+	 */
+	public function getFile($url) {
+		return $this->send('GET', $url);
+	}
+
+	/**
+	 * Put a file to server.
+	 *
+	 * @param	string	Absolute path to file
+	 * @param	integer	Reference ID where uploaded file belongs to, optional
+	 * @return	array	Result
+	 * @throws	KerioApiException
+	 */
+	public function uploadFile($filename, $id = null) {
+		$data = @file_get_contents($filename);
+
+		if ($data) {
+			$this->debug(sprintf('Uploading file %s', $filename));
+			$json_response = $this->send('PUT', $data);
+		}
+		else {
+			throw new KerioApiException(sprintf('Unable to open file %s', $filename));
+		}
+
+		$response = json_decode($json_response, TRUE);
+		return $response['result'];
+	}
+
+	/**
+	 * Check HTTP/1.1 reponse header.
+	 *
+	 * @param	integer	Requested HTTP code
+	 * @param	string	HTTP headers
+	 * @return	boolean	True if match
+	 * @throws	KerioApiException
+	 */
+	protected function checkHttpResponse($code, $headers) {
+		preg_match('#HTTP/\d+\.\d+ (\d+) (.+)#', $headers, $result);
+		switch ($result[1]) {
+			case $code:
+				return TRUE;
+			default:
+				$remote = sprintf('https://%s:%d%s', $this->hostname, $this->jsonRpc['port'], $this->jsonRpc['api']);
+				throw new KerioApiException(sprintf('%d - %s on remote server %s', $result[1], $result[2], $remote));
+		}
+	}
+
+	/**
+	 * Set hostname.
+	 *
+	 * @param	string	Hostname
+	 * @return	void
+	 */
+	public function setHostname($hostname) {
+		$hostname = preg_split('/:/', $hostname);
+		$this->hostname = $hostname[0];
+		if (isset($hostname[1])) {
+			$this->setJsonRpc($this->jsonRpc['version'], $hostname[1], $this->jsonRpc['api']);
+		}
+	}
+
+	/**
+	 * Get request ID.
+	 *
+	 * @param	void
+	 * @return	integer
+	 */
+	private function getRequestId() {
+		$this->requestId++;
+		return $this->requestId;
+	}
+
+	/**
+	 * Set security Cross-Site Request Forgery X-Token.
+	 *
+	 * @param	string	X-Token value
+	 * @return	void
+	 */
+	protected function setToken($token) {
+		$this->debug(sprintf('Setting X-Token %s.', $token));
+		$this->token = $token;
+	}
+
+	/**
+	 * Get security Cross-Site Request Forgery X-Token.
+	 *
+	 * @param	void
+	 * @return	string	X-Token value
+	 */
+	public function getToken() {
+		return $this->token;
+	}
+
+	/**
+	 * Set Cookies.
+	 *
+	 * @param	string	Cookies
+	 * @return	void
+	 */
+	protected function setCookie($cookies) {
+		$this->cookies = $cookies;
+	}
+
+	/**
+	 * Get Cookies.
+	 *
+	 * @param	void
+	 * @return	string	Cookies
+	 */
+	public function getCookie() {
+		return $this->cookies;
+	}
+
+	/**
+	 * Set Cookie from response.
+	 *
+	 * @param	string	HTTP headers
+	 * @return	void
+	 */
+	private function setCookieFromHeaders($headers) {
+		foreach (explode("\n", $headers) as $line) {
+			if (preg_match_all('/Set-Cookie:\s(\w*)=(\w*)/', $line, $result)) {
+				foreach ($result[1] as $index => $cookie) {
+					$this->debug(sprintf('Setting %s=%s.', $cookie, $result[2][$index]));
+					$this->setCookie(sprintf('%s %s=%s;', $this->getCookie(), $cookie, $result[2][$index]));
+				}
+			}
+		}
+	}
+
+	/**
+	 * Set connection timeout.
+	 *
+	 * @param	integer	Timeout in seconds
+	 * @return	void
+	 */
+	public function setTimeout($timeout) {
+		$this->timeout = (integer) $timeout;
+	}
+}

api/class/KerioApiException.php

@@ -0,0 +1,117 @@
+<?php
+/**
+ * This file is part of the kerio-api-php.
+ *
+ * Copyright (c) Kerio Technologies s.r.o.
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code
+ * or visit Developer Zone. (http://www.kerio.com/developers)
+ *
+ * Do not modify this source code.
+ * Any changes may be overwritten by a new version.
+ */
+
+/**
+ * Kerio API Exception Class.
+ *
+ * This class extends Exception class to provide CSS-based error message formating.
+ *
+ * @copyright	Copyright &copy; 2012-2012 Kerio Technologies s.r.o.
+ * @license		http://www.kerio.com/developers/license/sdk-agreement
+ * @version		1.4.0.234
+ */
+class KerioApiException extends Exception {
+
+	/**
+	 * Positional parameters
+	 * @var	array
+	 */
+	private $positionalParameters = array();
+
+	/**
+	 * Error code
+	 * @var	integer
+	 */
+	protected $code;
+
+	/**
+	 * Error message
+	 * @var	string
+	 */
+	protected $message = '';
+
+	/**
+	 * Request message
+	 * @var	string
+	 */
+	protected $request = '';
+
+	/**
+	 * Response message
+	 * @var	string
+	 */
+	protected $response = '';
+
+	/**
+	 * Exception contructor.
+	 *
+	 * @param 	string	Message to display
+	 * @param	mixed	Can be integer or string
+	 * @param	array	Positional parameters in message
+	 * @return	void
+	 */
+	public function KerioApiException($message, $code = '', $positionalParameters = '', $request = '', $response = '') {
+		$this->message = $message;
+
+		if (is_int($code) || is_string($code)) {
+			$this->code = $code;
+		}
+		if (is_array($positionalParameters)) {
+			$this->positionalParameters = $positionalParameters;
+			$this->setPositionalParameterToString();
+		}
+		if (is_string($request)) {
+			$this->request = $request;
+		}
+		if (is_string($response)) {
+			$this->response = $response;
+		}
+
+	}
+
+	/**
+	 * Get request data.
+	 *
+	 * @return	string	JSON request
+	 */
+	public function getRequest() {
+		return $this->request;
+	}
+
+	/**
+	 * Get response data.
+	 *
+	 * @return	string	JSON response
+	 */
+	public function getResponse() {
+		return $this->response;
+	}
+
+	/**
+	 * Replace positional parameter with a string
+	 *
+	 * @return	void
+	 */
+	private function setPositionalParameterToString() {
+		if (preg_match_all('/%\d/', $this->message, $matches)) {
+			/* Found positional parameters */
+			$index = 0;
+			foreach ($matches[0] as $occurence) {
+				$replaceWith = $this->positionalParameters[$index];
+				$this->message = str_replace($occurence, $replaceWith, $this->message);
+				$index++;
+			}
+		}
+	}
+}

api/class/KerioApiInterface.php

@@ -0,0 +1,67 @@
+<?php
+/**
+ * This file is part of the kerio-api-php.
+ *
+ * Copyright (c) Kerio Technologies s.r.o.
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code
+ * or visit Developer Zone. (http://www.kerio.com/developers)
+ *
+ * Do not modify this source code.
+ * Any changes may be overwritten by a new version.
+ */
+
+/**
+ * Kerio API Interface.
+ *
+ * This interface describes basic methods for Kerio API.
+ *
+ * @copyright	Copyright &copy; 2012-2012 Kerio Technologies s.r.o.
+ * @license		http://www.kerio.com/developers/license/sdk-agreement
+ * @version		1.4.0.234
+ */
+interface KerioApiInterface {
+
+	/**
+	 * Class constructor.
+	 *
+	 * @param 	string
+	 * @param	string
+	 * @param	string
+	 */
+	public function __construct($name, $vendor, $version);
+
+	/**
+	 * Set JSON-RPC settings.
+	 *
+	 * @param 	string
+	 * @param 	integer
+	 * @param 	string
+	 */
+	public function setJsonRpc($version, $port, $api);
+
+	/**
+	 * Send request using method and its params.
+	 *
+	 * @param	string
+	 * @param	array
+	 */
+	public function sendRequest($method, $params = '');
+
+	/**
+	 * Login method.
+	 *
+	 * @param	string
+	 * @param	string
+	 * @param	string
+	 */
+	public function login($hostname, $username, $password);
+
+	/**
+	 * Logout method.
+	 *
+	 * @param	void
+	 */
+	public function logout();
+}

api/class/KerioApiSocket.php

@@ -0,0 +1,289 @@
+<?php
+/**
+ * This file is part of the kerio-api-php.
+ *
+ * Copyright (c) Kerio Technologies s.r.o.
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code
+ * or visit Developer Zone. (http://www.kerio.com/developers)
+ *
+ * Do not modify this source code.
+ * Any changes may be overwritten by a new version.
+ */
+
+require_once(dirname(__FILE__) . '/KerioApiSocketInterface.php');
+
+/**
+ * Kerio API Socket Class.
+ *
+ * This class implements basic methods used in HTTP communication.
+ *
+ * @copyright	Copyright &copy; 2012-2012 Kerio Technologies s.r.o.
+ * @license		http://www.kerio.com/developers/license/sdk-agreement
+ * @version		1.4.0.234
+ */
+class KerioApiSocket implements KerioApiSocketInterface {
+
+	/**
+	 * Socket buffer size
+	 */
+	const BUFFER_SIZE = 10240;
+
+	/**
+	 * Socket handler
+	 * @var resource
+	 */
+	private $socketHandler = '';
+
+	/**
+	 * Communication timeout
+	 * @var	integer
+	 */
+	private $timeout = 10;
+
+	/**
+	 * Server hostname
+	 * @var	string
+	 */
+	private $hostname = '';
+
+	/**
+	 * Server port
+	 * @var	integer
+	 */
+	private $port = '';
+
+	/**
+	 * SSL encryption
+	 * @var string
+	 */
+	private $cipher = 'ssl://';
+
+	/**
+	 * Headers
+	 * @var	string
+	 */
+	private $headers = '';
+
+	/**
+	 * Body
+	 * @var	string
+	 */
+	private $body = '';
+
+	/**
+	 * Socker error message
+	 * @var	string
+	 */
+	private $errorMessage = '';
+
+	/**
+	 * Socker error code
+	 * @var	integer
+	 */
+	private $errorCode = 0;
+
+	/**
+	 * Class constructor.
+	 *
+	 * @param	string	Hostname
+	 * @param	integer	Port
+	 * @param	integer	Timeout, optional
+	 * @return	boolean	True on success
+	 */
+	public function KerioApiSocket($hostname, $port, $timeout = '') {
+		/* Set host */
+		$this->hostname = $hostname;
+		$this->port = $port;
+
+		/* Set timeout */
+		if (is_int($timeout)) {
+			$this->timeout = $timeout;
+		}
+
+		/* Open socket to server */
+		$this->open();
+		return ($this->socketHandler) ? TRUE : FALSE;
+	}
+
+	/**
+	 * Class desctructor.
+	 *
+	 * @param	void
+	 * @return	void
+	 */
+	public function __destruct() {
+		$this->close();
+	}
+
+	/**
+	 * Open socket to server.
+	 *
+	 * @param	void
+	 * @return	void
+	 */
+	protected function open() {
+		$errstr = "";
+		$errno  = "";
+		$context = stream_context_create();
+		stream_context_set_option($context, "ssl", "allow_self_signed", true);
+		stream_context_set_option($context, "ssl", "verify_peer", false);
+		stream_context_set_option($context, "ssl", "verify_peer_name", false);
+		$this->socketHandler = @stream_socket_client($this->cipher . $this->hostname . ':' .  $this->port, $errno, $errstr, $this->timeout, STREAM_CLIENT_CONNECT, $context);
+		$this->errorCode = $errno;
+		$this->errorMessage = $errstr;
+	}
+
+	/**
+	 * Close socket to server.
+	 *
+	 * @param	void
+	 * @return	void
+	 */
+	protected function close() {
+		@fclose($this->socketHandler);
+		unset($this->socketHandler);
+	}
+
+	/**
+	 * Send data to socket.
+	 *
+	 * @see class/KerioApiSocketInterface::send()
+	 * @param	string	Data to socket
+	 * @return	string	Data from socket
+	 * @throws	KerioApiException
+	 */
+	public function send($data) {
+		if ($this->checkConnection()) {
+			@fwrite($this->socketHandler, $data);
+			return $this->read();
+		}
+		else {
+			throw new KerioApiException(sprintf("Cannot connect to %s using port %d.", $this->hostname, $this->port));
+		}
+	}
+
+	/**
+	 * Read data from socket.
+	 *
+	 * @param	void
+	 * @return	string	HTTP data from socket
+	 * @throws	KerioApiExceptions
+	 */
+	protected function read() {
+		if ($this->socketHandler) {
+			$response = '';
+			while (FALSE === feof($this->socketHandler)) {
+				$response .= fgets($this->socketHandler, self::BUFFER_SIZE);
+			}
+			
+			list($this->headers, $this->body) = explode("\r\n\r\n", $response);
+			
+			if (FALSE !== strpos(strtolower($this->headers), 'transfer-encoding: chunked')) {
+				$this->unchunkHttp();
+			}
+			
+			return $response;
+		}
+		else {
+			throw new KerioApiException('Cannot read data from server, connection timeout.');
+		}
+	}
+
+	/**
+	 * Unchunk HTTP/1.1 body.
+	 * 
+	 * @param	void
+	 * @return	void
+	 */
+	private function unchunkHttp() {
+		$body = $this->body;
+		for ($new = ''; !empty($body); $str = trim($body)) {
+			$pos  = strpos($body, "\r\n");
+			$len  = hexdec(substr($body, 0, $pos));
+			$new .= substr($body, $pos + 2, $len);
+			$body = substr($body, $pos + 2 + $len);
+		}
+		$this->body = $new;
+	}
+
+	/**
+	 * Set connection encryption to ssl://
+	 * 
+	 * @param	boolen	True if ssl:// is used
+	 * @return	void
+	 */
+	public function setEncryption($boolean) {
+		$this->cipher = ($boolean) ? 'ssl://' : '';
+	}
+
+	/**
+	 * Check connection to server.
+	 *
+	 * @param	void
+	 * @return	boolean	True on success
+	 */
+	public final function checkConnection() {
+		if ($this->checkHost()) {
+			$socket = @fsockopen($this->hostname, $this->port, $errno, $errstr, $this->timeout);
+			$this->errorCode = $errno;
+			$this->errorMessage = $errstr;
+			return ($socket) ? TRUE : FALSE;
+		}
+		else {
+			return FALSE;
+		}
+	}
+
+	/**
+	 * Check if DNS host is valid.
+	 *
+	 * @param 	void
+	 * @return	boolean	True on success
+	 */
+	public final function checkHost() {
+		return gethostbyname($this->hostname) ? TRUE : FALSE;
+	}
+
+	/**
+	 * Get headers.
+	 * 
+	 * @param	void
+	 * @return	string
+	 */
+	public final function getHeaders() {
+		return $this->headers;
+	}
+
+	/**
+	 * Get body.
+	 *
+	 * @param	void
+	 * @return	string
+	 */
+	 public final function getBody() {
+		return $this->body;
+	}
+
+	/**
+	 * Get socker error message.
+	 *
+	 * @param	void
+	 * @return	string
+	 */
+	public final function getErrorMessage() {
+		return $this->errorMessage;
+	}
+
+	/**
+	 * Get socket error code.
+	 *
+	 * @param	void
+	 * @return	integer
+	 */
+	public final function getErrorCode() {
+		return $this->errorCode;
+	}
+}
+

api/class/KerioApiSocketInterface.php

@@ -0,0 +1,32 @@
+<?php
+/**
+ * This file is part of the kerio-api-php.
+ *
+ * Copyright (c) Kerio Technologies s.r.o.
+ *
+ * For the full copyright and license information, please view
+ * the file license.txt that was distributed with this source code
+ * or visit Developer Zone. (http://www.kerio.com/developers)
+ *
+ * Do not modify this source code.
+ * Any changes may be overwritten by a new version.
+ */
+
+/**
+ * Kerio API Socket Interface.
+ *
+ * This interface describes basic methods used in HTTP communication.
+ *
+ * @copyright	Copyright &copy; 2012-2012 Kerio Technologies s.r.o.
+ * @license		http://www.kerio.com/developers/license/sdk-agreement
+ * @version		1.4.0.234
+ */
+interface KerioApiSocketInterface {
+
+	/**
+	 * Send data to socket.
+	 *
+	 * @param	string
+	 */
+	public function send($data);
+}