whmcs.class.php

<?php

class WHMCS {
	public $url;
	public $username;
	public $password;
	public $accesskey;

	public function __construct($url = 'http://whmcs.com/include/api.php', $username = 'username', $password = 'password', $accesskey = ''){
		$this->url = $url;
		$this->username = $username;
		$this->password = $password;
		$this->accesskey = $accesskey;
	}

	public function authenticate($username, $password){
		$response = $this->api("validatelogin", array("email" => $username, "password2" => $password));
		if($response->userid){
			return true;
		}

		return false;
	}

	public function getDomains($uid = 0, $domainId = 0, $domain = '', $start = 0, $limit = 0){
		if($limit <= 0){
			$limit = 9999;
		}

		$params['limitnum'] = $limit;
		$params['limitstart'] = $start;

		if($uid > 0){
			$params['clientid'] = $uid;
		}

		if($domainId > 0){
			$params['domainid'] = $domainId;
		}

		if($domain){
			$params['domain'] = $domain;
		}

		$response = $this->api("getclientsdomains", $params);

		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}

		return $response;
	}
	
	public function getDomainNameservers($domainId){
	    $params['domainid'] = $domainId;
	    $response = $this->api("domaingetnameservers", $params);

		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}

		return $response;
	}
	
	public function getDomainLock($domainId){
	    $params['domainid'] = $domainId;
	    $response = $this->api("domaingetlockingstatus", $params);

		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}

		return $response;	    
	}
	
	public function getDomainWHOIS($domainId){
        $params['domainid'] = $domainId;
	    $response = $this->api("domaingetwhoisinfo", $params);

		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}

		return $response;
	}

	public function getServices($uid = 0, $serviceId = 0, $domain = '', $productId = 0, $serviceUsername = '', $start = 0, $limit = 0){
		if($limit <= 0){
			$limit = 9999;
		}

		$params['limitnum'] = $limit;
		$params['limitstart'] = $limitstart;

		if($uid > 0){
			$params['clientid'] = $uid;
		}

		if($serviceId > 0){
			$params['serviceid'] = $serviceId;
		}

		if($domain){
			$params['domain'] = $domain;
		}

		if($productId){
			$params['pid'] = $productId;
		}

		if($serviceUsername){
			$params['username2'] = $serviceUsername;
		}

		$response = $this->api("getclientsproducts", $params);

		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}

		return $response;
	}

	public function getTransactions($uid = 0, $invoiceId = 0, $transactionId = 0){
		if($uid > 0){
			$params['clientid'] = $uid;
		}

		if($invoiceId > 0){
			$params['invoiceid'] = $invoiceId;
		}

		if($transactionId > 0){
			$params['transid'] = $transactionId;
		}

		$response = $this->api("gettransactions", $params);

		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}

		return $response;
	}

	public function getEmails($uid, $filter = '', $filterdate = '', $start = 0, $limit = 0){
		$params['clientid'] = $uid;

		if($filter){
			$params['subject'] = $filter;
		}

		if($filterdate){
			$params['date'] = $filterdate;
		}

		if(!$limit <= 0){
			$limit = 9999;
		}

		$params['limitnum'] = $limit;
		$params['limitstart'] = $start;

		$response = $this->api("getemails", $params);

		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}

		return $response;
	}

	public function getCredits($uid){
		return $this->api("getcredits", array("clientid" => $uid));
	}

	public function updateClient($uid = 0, $update){
		$attributes = array("firstname", "lastname", "companyname", "email", "address1", "address2", "city", "state", "postcode", "country", "phonenumber", "password2", "credit", "taxexempt", "notes", "cardtype", "cardnum", "expdate", "startdate", "issuenumber", "language", "customfields", "status", "latefeeoveride", "overideduenotices", "disableautocc");
	
		foreach($attributes as $k){
		    if(isset($update[$k])){
			    $params[$k] = $update[$k];
		    }
		}

		$params['clientid'] = $uid;

		$response = $this->api("updateclient", $params);

		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}
	}

	public function addClient($data){
		$attributes = array("firstname", "lastname", "companyname", "email", "address1", "address2", "city", "state", "postcode", "country", "phonenumber", "password2", "currency", "clientip", "language", "groupid", "securityqid", "securityqans", "notes", "cctype", "cardnum", "expdate", "startdate", "issuenumber", "customfields", "noemail", "skipvalidation");
	
		foreach($attributes as $k){
			$customer[$k] = $data[$k];
		}

		if($customer['skipvalidation'] != true){
			if(!$customer['firstname'] || !$customer['lastname'] || !$customer['email'] || !$customer['address1'] || !$customer['city'] || !$customer['state'] || !$customer['postcode'] || !$customer['country'] || !$customer['phonenumber'] || !$customer['password2']){
				throw new WhmcsException("Required fields missing.");
			}
		}

		$response = $this->api("addclient", $customer);

		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}
	}	

	public function getClient($uid = 0, $email = ''){
		if($uid > 0){
			$params = array("clientid" => $uid);
		}elseif($email){
			$params = array("email" => $email);
		}else{
			return false;
		}

		$params['stats'] = true;

		$response = $this->api("getclientsdetails", $params);

		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}

		return $response;
	}
	
	public function getInvoice($invoiceid){
		return $this->api("getinvoice", array("invoiceid" => $invoiceid));
	}
	
	public function getInvoices($uid = 0, $status = '', $start = 0, $limit = 0){
		if($uid > 0){
			$params['userid'] = $uid;
		}

		if($status == "Unpaid" || $status == "Paid" || $status == "Refunded" || $status == "Cancelled" || $status == "Collections"){
			$params['status'] = $status;
		}

		if(!$limit <= 0){
			$limit = 9999;
		}

		$params['limitnum'] = $limit;
		$params['limitstart'] = $start;

		$response = $this->api("getinvoices", $params);

		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}

		return $response;
	}
	
	public function addInvoicePayment($invoiceid, $txid, $amount = 0, $gateway, $date = ''){
		if($amount > 0){
			$params['amount'] = $amount;
		}
		
		if($date){
			$params['date'] = $date;
		}
		
		$params['transid'] = $txid;
		$params['gateway'] = $gateway;
		$params['invoiceid'] = $invoiceid;
		
		$response = $this->api("addinvoicepayment", $params);
		
		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}
		
		return $response;
	}

	public function getOrders($uid = 0, $orderId = 0, $status = '', $start = 0, $limit = 0){
		if($uid > 0){
			$params['userid'] = $uid;
		}

		if($orderId > 0){
			$params['id'] = $invoiceId;
		}

		if($status == "Pending" || $status == "Active" || $status == "Fraud" || $status == "Cancelled"){
			$params['status'] = $status;
		}

		if(!$limit <= 0){
			$limit = 9999;
		}

		$params['limitnum'] = $limit;
		$params['limitstart'] = $start;

		$response = $this->api("getorders", $params);

		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}

		return $response;
	}
	
	public function addOrder($uid, $productdata, $paymentmethod, $clientip, $promocode = null, $affid = null, $noemail = false, $noinvoice = false, $noinvoiceemail = false, $otherparams){
	    if($promocode){
	        $params['promocode'] = $promocode;
	    }
	    if($affid){
	        $params['affid'] = $affid;
	    }
	    if($noemail){
	        $params['noemail'] = "true";
	    }
	    if($noinvoice){
	        $params['noinvoice'] = "true";
	    }
	    if($noinvoiceemail){
	        $params['noinvoiceemail'] = "true";
	    }
	    
	    $params['clientid'] = $uid;
	    $params['paymentmethod'] = $paymentmethod;
	    $params['clientip'] = $clientip;
	    
	    $i = 0;
	    foreach($productdata as $product){
	        foreach($product as $key => $val){
	            if($key == "customfields" || $key == "configoptions" || $key == "domainfields"){
	                $val = base64_encode(serialize($val));
	            }
	            $params[$key.'['.$i.']'] = $val;
	        }
	        $i++;
	    }
	    
	    foreach($otherparams as $key => $val){
	        $params[$key] = $val;
	    }
	    
	    $response = $this->api('addorder', $params);
	    
		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}

		return $response;	    
	}

	public function getStats(){
		$response = $this->api("getstats", $params);

		if($response->result == 'error'){
			throw new WhmcsException("WHMCS complained: ".$response->message);
		}

		return $response;
	}

	public function api($action, $params){
		$postfields = array();
		$postfields['username'] = $this->username;
		$postfields['password'] = md5($this->password);
		$postfields['responsetype'] = 'json';
		$postfields['action'] = $action;

		if($this->accesskey != ''){
			$postfields['accesskey'] = $this->accesskey;
		}

		foreach($params as $k => $v){
			$postfields[$k] = $v;
		}

                /** old query string */
                // $queryString = "";
                // foreach($postfields as $k => $v){
                //     $queryString .= $k."=".urlencode($v)."&";
                // }

                /** new one to handle arrays as well */
                $queryString = http_build_query($postfields);

		$ch = curl_init();
		curl_setopt($ch, CURLOPT_URL, $this->url);
		curl_setopt($ch, CURLOPT_POST, true);
		curl_setopt($ch, CURLOPT_TIMEOUT, 30);
		curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
		curl_setopt($ch, CURLOPT_POSTFIELDS, $queryString);
		curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
		curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);

		$response = curl_exec($ch);
		if(curl_error($ch)){ throw new Exception(curl_error($ch)); }
		curl_close($ch);

		return(json_decode($response));
	}
}

class WhmcsException extends Exception {}