Location: PHPKode > projects > php-opencloud > php-opencloud-master/lib/domain.php
<?php
/**
 * Defines a DNS domain
 *
 * @copyright 2012-2013 Rackspace Hosting, Inc.
 * See COPYING for licensing information
 *
 * @package phpOpenCloud
 * @version 1.0
 * @author Glen Campbell <hide@address.com>
 */

namespace OpenCloud\DNS;

require_once(__DIR__.'/dnsobject.php');
require_once(__DIR__.'/record.php');

/**
 * The Domain class represents a single domain
 *
 * Note that the `Subdomain` class is defined in this same file because of
 * mutual dependencies.
 *
 * @api
 * @author Glen Campbell <hide@address.com>
 */
class Domain extends DnsObject {

	public
		$id,
		$accountId,
		$ttl,
		$updated,
		$emailAddress,
		$created,
		$name,
		$comment;

	protected static
		$json_name = FALSE,
		$json_collection_name = 'domains',
		$url_resource = 'domains';

	protected
		$_create_keys = array('name','emailAddress','ttl','comment'),
		$_update_keys = array('emailAddress','ttl','comment');

	private
		$records = array(),
		$subdomains = array();

	/**
	 * returns a Record object
	 *
	 * Note that this method is available at the DNS level, but only for
	 * PTR records.
	 *
	 * @return Record
	 */
	public function Record($info=NULL) {
		return new Record($this, $info);
	}

	/**
	 * returns a Collection of Record objects
	 *
	 * @param array $filter query-string parameters
	 * @return \OpenCloud\Collection
	 */
	public function RecordList($filter=array()) {
		return $this->Parent()->Collection(
			'\OpenCloud\DNS\Record', NULL, $this, $filter);
	}

	/**
	 * returns a Subdomain object (child of current domain)
	 *
	 */
	public function Subdomain($info=array()) {
		return new Subdomain($this, $info);
	}

	/**
	 * returns a Collection of subdomains
	 *
	 * The subdomains are all `DNS:Domain` objects that are children of
	 * the current domain.
	 *
	 * @param array $filter key/value pairs for query string parameters
	 * return \OpenCloud\Collection
	 */
	public function SubdomainList($filter=array()) {
		return $this->Parent()->Collection(
			'\OpenCloud\DNS\Subdomain', NULL, $this);
	}

	/**
	 * Adds a new record to the list (for multiple record creation)
	 *
	 * @api
	 * @param Record $rec the record to add
	 * @return integer the number of records
	 */
	public function AddRecord(Record $rec) {
		$this->records[] = $rec;
		return count($this->records);
	}

	/**
	 * adds a new subdomain (for multiple subdomain creation)
	 *
	 * @api
	 * @param Subdomain $subd the subdomain to add
	 * @return integer the number of subdomains
	 */
	public function AddSubdomain(Subdomain $subd) {
		$this->subdomains[] = $subd;
		return count($this->subdomains);
	}

	/**
	 * returns changes since a specified date/time
	 *
	 * @param string $since the date or time
	 * @return DNS\Changes
	 */
	public function Changes($since=NULL) {
		if (isset($since))
			$url = $this->Url('changes', array('since'=>$since));
		else
			$url = $this->Url('changes');

		// perform the request
		$obj = $this->Service()->SimpleRequest($url);

		return $obj;
	}

	/**
	 * exports the domain
	 *
	 * @return AsyncResponse
	 */
	public function Export() {
		$url = $this->Url('export');
		return $this->Service()->AsyncRequest($url);
	}

	/* ---------- PROTECTED METHODS ---------- */

	/**
	 * handles creation of multiple records at Create()
	 *
	 * @api
	 * @return \stdClass
	 */
	protected function CreateJson() {
		$obj = parent::CreateJson();

		// add records, if any
		if (count($this->records) > 0) {
			$recobj = new \stdClass;
			$recobj->records = array();
			foreach($this->records as $rec) {
				$robj = new \stdClass;
				foreach($rec->CreateKeys() as $key)
					if (isset($rec->$key))
						$robj->$key = $rec->$key;
				$recobj->records[] = $robj;
			}
			$obj->domains[0]->recordsList = $recobj;
		}

		// add subdomains, if any
		if (count($this->subdomains) > 0) {
			$sub = new \stdClass;
			$sub->domains = array();
			foreach($this->subdomains as $subdom) {
				$sobj = new \stdClass;
				foreach($subdom->CreateKeys() as $key)
					if (isset($subdom->$key))
						$sobj->$key = $subdom->$key;
				$sub->domains[] = $sobj;
			}
			$obj->domains[0]->subdomains = $sub;
		}

		return $obj;
	}

} // class Domain

/**
 * The Subdomain is basically another domain, albeit one that is a child of
 * a parent domain. In terms of the code involved, the JSON is slightly
 * different than a top-level domain, and the parent is a domain instead of
 * the DNS service itself.
 */
class Subdomain extends Domain {

	protected static
		$json_name = FALSE,
		$json_collection_name = 'domains',
		$url_resource = 'subdomains';

	private
		$_parent;

	/**
	 */
	public function __construct(Domain $parent, $info=array()) {
		$this->_parent = $parent;
		return parent::__construct($parent->Service(), $info);
	}

	/**
	 * returns the parent domain object
	 */
	public function Parent() {
		return $this->_parent;
	}

} // class Subdomain
Return current item: php-opencloud