Your IP : 216.73.216.240
<?php
/**
* @version $Id: gantryregistry.class.php 30074 2016-03-15 08:01:58Z matias $
* @author RocketTheme http://www.rockettheme.com
* @copyright Copyright (C) 2007 - 2016 RocketTheme, LLC
* @license http://www.gnu.org/licenses/gpl-2.0.html GNU/GPLv2 only
*
* derived from Joomla with original copyright and license
* @copyright Copyright (C) 2005 - 2010 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('GANTRY_VERSION') or die;
gantry_import('core.utilities.registry.gantryregistryformat');
gantry_import('core.utilities.gantryarrayhelper');
class GantryRegistry
{
/**
* Registry Object
*
* @var object
*/
protected $data;
/**
* Constructor
*
* @return void
* @since 1.5
*/
public function __construct($data = null)
{
// Instantiate the internal data object.
$this->data = new stdClass();
// Optionally load supplied data.
if (is_array($data) || is_object($data)) {
$this->bindData($this->data, $data);
} elseif (!empty($data) && is_string($data)) {
$this->loadString($data);
}
}
/**
* Magic function to clone the registry object.
*/
public function __clone()
{
$this->data = unserialize(serialize($this->data));
}
/**
* Magic function to render this object as a string using default args of toString method.
*/
public function __toString()
{
return $this->toString();
}
/**
* Sets a default value if not alreay assigned.
*
* @param string The name of the parameter.
* @param string An optional value for the parameter.
* @param string An optional group for the parameter.
*
* @return string The value set, or the default if the value was not previously set (or null).
* @since 1.6
*/
public function def($key, $default = '')
{
$value = $this->get($key, (string)$default);
$this->set($key, $value);
return $value;
}
/**
* Check if a registry path exists.
*
* @param string Registry path (e.g. joomla.content.showauthor)
*
* @return boolean
* @since 1.6
*/
public function exists($path)
{
// Explode the registry path into an array
if ($nodes = explode('.', $path)) {
// Initialize the current node to be the registry root.
$node = $this->data;
$found = false;
// Traverse the registry to find the correct node for the result.
foreach ($nodes as $n)
{
if (is_array($node) && isset($node[$n]))
{
$node = $node[$n];
$found = true;
continue;
}
if (!isset($node->{$n}))
{
return false;
}
$node = $node->{$n};
$found = true;
}
}
return $found;
}
/**
* Get a registry value.
*
* @param string Registry path (e.g. joomla.content.showauthor)
* @param mixed Optional default value, returned if the internal value is null.
*
* @return mixed Value of entry or null
* @since 1.6
*/
public function get($path, $default = null)
{
// Initialise variables.
$result = $default;
if (!strpos($path, '.')) {
return (isset($this->data->{$path}) && !is_null($this->data->{$path})) ? $this->data->{$path} : $default;
}
// Explode the registry path into an array
$nodes = explode('.', $path);
// Initialize the current node to be the registry root.
$node = $this->data;
$found = false;
// Traverse the registry to find the correct node for the result.
foreach ($nodes as $n) {
if (is_object($node) && isset($node->{$n})) {
$node = $node->{$n};
$found = true;
} elseif (is_array($node) && array_key_exists($n, $node)) {
$node = $node[$n];
$found = true;
} else {
$found = false;
break;
}
}
if ($found && $node !== null) {
$result = $node;
}
return $result;
}
/**
* Returns a reference to a global GantryRegistry object, only creating it
* if it doesn't already exist.
*
* This method must be invoked as:
* <pre>$registry = GantryRegistry::getInstance($id);</pre>
*
* @param string An ID for the registry instance
*
* @return object The GantryRegistry object.
* @since 1.5
*/
public static function getInstance($id)
{
static $instances;
if (!isset ($instances)) {
$instances = array();
}
if (empty ($instances[$id])) {
$instances[$id] = new GantryRegistry();
}
return $instances[$id];
}
/**
* Load a associative array of values into the default namespace
*
* @param array Associative array of value to load
* @param string The name of the namespace
*
* @return boolean True on success
* @since 1.5
*/
public function loadArray($array)
{
$this->bindData($this->data, $array);
return true;
}
/**
* Load the public variables of the object into the default namespace.
*
* @param object The object holding the public vars to load
* @param string Namespace to load the INI string into [optional]
*
* @return boolean True on success
* @since 1.5
*/
public function loadObject($object)
{
$this->bindData($this->data, $object);
return true;
}
/**
* Load the contents of a file into the registry
*
* @param string Path to file to load
* @param string Format of the file [optional: defaults to JSON]
* @param mixed Options used by the formatter
*
* @return boolean True on success
* @since 1.5
*/
// public function loadFile($file, $format = 'JSON', $options = array())
// {
// // Get the contents of the file
// jimport('joomla.filesystem.file');
// $data = JFile::read($file);
//
// return $this->loadString($data, $format, $options);
// }
/**
* Load a string into the registry
*
* @param string string to load into the registry
* @param string format of the string
* @param mixed Options used by the formatter
*
* @return boolean True on success
* @since 1.5
*/
public function loadString($data, $format = 'JSON', $options = array())
{
// Load a string into the given namespace [or default namespace if not given]
$handler = GantryRegistryFormat::getInstance($format);
$obj = $handler->stringToObject($data, $options);
$this->loadObject($obj);
return true;
}
/**
* Merge a GantryRegistry object into this one
*
* @param object Source GantryRegistry object ot merge
*
* @return boolean True on success
* @since 1.5
*/
public function merge(&$source)
{
if ($source instanceof GantryRegistry) {
// Load the variables into the registry's default namespace.
foreach ($source->toArray() as $k => $v) {
if (($v !== null) && ($v !== '')) {
$this->_mergeItem($k, $v);
}
}
return true;
}
return false;
}
protected function _mergeItem($key, $value)
{
if (($value !== null) && ($value !== '')) {
if (is_object($value)) {
$object_vars = get_object_vars($value);
foreach ($object_vars as $subkey => $subvalue) {
$this->_mergeItem($key . '.' . $subkey, $subvalue);
}
} elseif (is_array($value)) {
foreach ($value as $subkey => $subvalue) {
$this->_mergeItem($key . '.' . $subkey, $subvalue);
}
} else {
$this->set($key, $value);
}
}
}
/**
* Set a registry value.
*
* @param string Registry Path (e.g. joomla.content.showauthor)
* @param mixed Value of entry
*
* @return mixed The value of the that has been set.
* @since 1.6
*/
public function set($path, $value)
{
$result = null;
// Explode the registry path into an array
if ($nodes = array_values(array_filter(explode('.', $path), 'strlen'))) {
// Initialize the current node to be the registry root.
$node = $this->data;
// Traverse the registry to find the correct node for the result.
for ($i = 0, $n = count($nodes) - 1; $i < $n; $i++) {
if (is_object($node))
{
if (!isset($node->{$nodes[$i]}) && ($i != $n))
{
$node->{$nodes[$i]} = new \stdClass;
}
// Pass the child as pointer in case it is an object
$node = &$node->{$nodes[$i]};
continue;
}
if (is_array($node))
{
if (!isset($node[$nodes[$i]]) && ($i != $n))
{
$node[$nodes[$i]] = new \stdClass;
}
// Pass the child as pointer in case it is an array
$node = &$node[$nodes[$i]];
}
}
// Get the old value if exists so we can return it
switch (true)
{
case (is_object($node)):
$result = $node->{$nodes[$i]} = $value;
break;
case (is_array($node)):
$result = $node[$nodes[$i]] = $value;
break;
default:
$result = null;
break;
}
return $result;
}
return $result;
}
/**
* Transforms a namespace to an array
*
* @param string Namespace to return [optional: null returns the default namespace]
*
* @return array An associative array holding the namespace data
* @since 1.5
*/
public function toArray()
{
return (array)$this->asArray($this->data);
}
/**
* Transforms a namespace to an object
*
* @param string Namespace to return [optional: null returns the default namespace]
*
* @return object An an object holding the namespace data
* @since 1.5
*/
public function toObject()
{
return $this->data;
}
/**
* Get a namespace in a given string format
*
* @param string Format to return the string in
* @param mixed Parameters used by the formatter, see formatters for more info
*
* @return string Namespace in string format
* @since 1.5
*/
public function toString($format = 'JSON', $options = array())
{
// Return a namespace in a given format
$handler = GantryRegistryFormat::getInstance($format);
return $handler->objectToString($this->data, $options);
}
/**
* Method to recursively bind data to a parent object.
*
* @param object $parent The parent object on which to attach the data values.
* @param mixed $data An array or object of data to bind to the parent object.
*
* @return void
* @since 1.6
*/
protected function bindData(& $parent, $data)
{
// Ensure the input data is an array.
if (is_object($data)) {
$data = get_object_vars($data);
} else {
$data = (array)$data;
}
foreach ($data as $k => $v) {
if ((is_array($v) && GantryArrayHelper::isAssociative($v)) || is_object($v)) {
$parent->{$k} = new stdClass();
$this->bindData($parent->{$k}, $v);
} else {
$parent->{$k} = $v;
}
}
}
/**
* Method to recursively convert an object of data to an array.
*
* @param object $data An object of data to return as an array.
*
* @return array Array representation of the input object.
* @since 1.6
*/
protected function asArray($data)
{
$array = array();
foreach (get_object_vars((object)$data) as $k => $v) {
if (is_object($v)) {
$array[$k] = $this->asArray($v);
} else {
$array[$k] = $v;
}
}
return $array;
}
//
// Following methods are deprecated
//
/**
* Load an XML string into the registry into the given namespace [or default if a namespace is not given]
*
* @param string XML formatted string to load into the registry
* @param string Namespace to load the XML string into [optional]
*
* @return boolean True on success
* @since 1.5
* @deprecated 1.6 - Oct 25, 2010
*/
public function loadXML($data, $namespace = null)
{
return $this->loadString($data, 'XML');
}
/**
* Load an INI string into the registry into the given namespace [or default if a namespace is not given]
*
* @param string INI formatted string to load into the registry
* @param string Namespace to load the INI string into [optional]
* @param mixed An array of options for the formatter, or boolean to process sections.
*
* @return boolean True on success
* @since 1.5
* @deprecated 1.6 - Oct 25, 2010
*/
public function loadINI($data, $namespace = null, $options = array())
{
return $this->loadString($data, 'INI', $options);
}
/**
* Load an JSON string into the registry into the given namespace [or default if a namespace is not given]
*
* @param string JSON formatted string to load into the registry
*
* @return boolean True on success
* @since 1.5
* @deprecated 1.6 - Oct 25, 2010
*/
public function loadJSON($data)
{
return $this->loadString($data, 'JSON');
}
/**
* Create a namespace
*
* @param string Name of the namespace to create
*
* @return boolean True on success
* @since 1.5
* @deprecated 1.6 - Jan 19, 2010
*/
public function makeNameSpace($namespace)
{
//$this->_registry[$namespace] = array('data' => new stdClass());
return true;
}
/**
* Get the list of namespaces
*
* @return array List of namespaces
* @deprecated 1.6 - Jan 19, 2010
*/
public function getNameSpaces()
{
//return array_keys($this->_registry);
return array();
}
/**
* Get a registry value
*
* @param string Registry path (e.g. joomla.content.showauthor)
* @param mixed Optional default value
*
* @return mixed Value of entry or null
* @deprecated 1.6 - Jan 19, 2010
*/
public function getValue($path, $default = null)
{
$parts = explode('.', $path);
if (count($parts) > 1) {
unset($parts[0]);
$path = implode('.', $parts);
}
return $this->get($path, $default);
}
/**
* Set a registry value
*
* @param string Registry Path (e.g. joomla.content.showauthor)
* @param mixed Value of entry
*
* @return mixed The value after setting.
* @deprecated 1.6 - Jan 19, 2010
*/
public function setValue($path, $value)
{
$parts = explode('.', $path);
if (count($parts) > 1) {
unset($parts[0]);
$path = implode('.', $parts);
}
return $this->set($path, $value);
}
/**
* This method is added as an interim solution for API references in Joomla! 1.6 to the JRegistry
* object where in 1.5 a JParameter object existed. Because many extensions may call this method
* we add it here as a means of "pain relief" until the 1.7 release.
*
* @return boolean True.
*
* @deprecated 1.6 - Jun 17, 2010
* @todo Remove this method for the 1.7 release.
*/
public function loadSetupFile()
{
return true;
}
}