Registry
Implements \JsonSerializable, \ArrayAccess, \IteratorAggregate, \CountableRegistry class
since |
1.0 |
---|
Methods
__clone
Magic function to clone the registry object.
__clone() : void
since |
1.0 |
---|
__construct
Constructor
__construct(mixed $data = null)
since |
1.0 |
---|
Arguments
- $data
mixed
The data to bind to the new Registry object.
__toString
Magic function to render this object as a string using default args of toString method.
__toString() : string
since |
1.0 |
---|
Response
string
append
Append value to a path in registry
append(string $path, mixed $value) : mixed
since |
1.4.0 |
---|
Arguments
- $path
string
Parent registry Path (e.g. joomla.content.showauthor)- $value
mixed
Value of entry
Response
mixed
The value of the that has been set.
asArray
Method to recursively convert an object of data to an array.
asArray(object $data) : array
since |
1.0 |
---|
Arguments
- $data
object
An object of data to return as an array.
Response
array
Array representation of the input object.
bindData
Method to recursively bind data to a parent object.
bindData(object $parent, mixed $data, boolean $recursive = true, boolean $allowNull = true) : void
since |
1.0 |
---|
Arguments
- $parent
object
The parent object on which to attach the data values.- $data
mixed
An array or object of data to bind to the parent object.- $recursive
boolean
True to support recursive bindData.- $allowNull
boolean
True to allow null values.
count
Count elements of the data object
count() : integer
link | |
---|---|
since |
1.3.0 |
Response
integer
The custom count as an integer.
def
Sets a default value if not already assigned.
def(string $key, mixed $default = '') : mixed
since |
1.0 |
---|
Arguments
- $key
string
The name of the parameter.- $default
mixed
An optional value for the parameter.
Response
mixed
The value set, or the default if the value was not previously set (or null).
exists
Check if a registry path exists.
exists(string $path) : boolean
since |
1.0 |
---|
Arguments
- $path
string
Registry path (e.g. joomla.content.showauthor)
Response
boolean
extract
Method to extract a sub-registry from path
extract(string $path) : \Joomla\Registry\Registry|null
since |
1.2.0 |
---|
Arguments
- $path
string
Registry path (e.g. joomla.content.showauthor)
Response
\Joomla\Registry\Registry|null
Registry object if data is present
flatten
Dump to one dimension array.
flatten(string $separator = null) : array<mixed,string>
since |
1.3.0 |
---|
Arguments
- $separator
string
The key separator.
Response
array<mixed,string>
Dumped array.
get
Get a registry value.
get(string $path, mixed $default = null) : mixed
since |
1.0 |
---|
Arguments
- $path
string
Registry path (e.g. joomla.content.showauthor)- $default
mixed
Optional default value, returned if the internal value is null.
Response
mixed
Value of entry or null
getInstance
Returns a reference to a global Registry object, only creating it if it doesn't already exist.
getInstance(string $id) : \Joomla\Registry\Registry
This method must be invoked as:
$registry = Registry::getInstance($id);
since |
1.0 |
---|---|
deprecated |
2.0 Instantiate a new Registry instance instead |
Arguments
- $id
string
An ID for the registry instance
Response
\Joomla\Registry\Registry
The Registry object.
getIterator
Gets this object represented as an ArrayIterator.
getIterator() : \ArrayIterator
This allows the data properties to be accessed via a foreach statement.
see | \Joomla\Registry\IteratorAggregate::getIterator() |
---|---|
since |
1.3.0 |
Response
\ArrayIterator
This object represented as an ArrayIterator.
jsonSerialize
Implementation for the JsonSerializable interface.
jsonSerialize() : object
Allows us to pass Registry objects to json_encode.
since |
1.0 |
---|---|
note |
The interface is only present in PHP 5.4 and up. |
Response
object
loadArray
Load an associative array of values into the default namespace
loadArray(array $array, boolean $flattened = false, string $separator = null) : \Joomla\Registry\Registry
since |
1.0 |
---|
Arguments
- $array
array
Associative array of value to load- $flattened
boolean
Load from a one-dimensional array- $separator
string
The key separator
Response
\Joomla\Registry\Registry
Return this object to support chaining.
loadFile
Load the contents of a file into the registry
loadFile(string $file, string $format = 'JSON', array $options = array()) : \Joomla\Registry\Registry
since |
1.0 |
---|
Arguments
- $file
string
Path to file to load- $format
string
Format of the file [optional: defaults to JSON]- $options
array
Options used by the formatter
Response
\Joomla\Registry\Registry
Return this object to support chaining.
loadObject
Load the public variables of the object into the default namespace.
loadObject(object $object) : \Joomla\Registry\Registry
since |
1.0 |
---|
Arguments
- $object
object
The object holding the publics to load
Response
\Joomla\Registry\Registry
Return this object to support chaining.
loadString
Load a string into the registry
loadString(string $data, string $format = 'JSON', array $options = array()) : \Joomla\Registry\Registry
since |
1.0 |
---|
Arguments
- $data
string
String to load into the registry- $format
string
Format of the string- $options
array
Options used by the formatter
Response
\Joomla\Registry\Registry
Return this object to support chaining.
merge
Merge a Registry object into this one
merge(\Joomla\Registry\Registry $source, boolean $recursive = false) : \Joomla\Registry\Registry|false
since |
1.0 |
---|
Arguments
- $source
\Joomla\Registry\Registry
Source Registry object to merge.- $recursive
boolean
True to support recursive merge the children values.
Response
\Joomla\Registry\Registry|false
Return this object to support chaining or false if $source is not an instance of Registry.
offsetExists
Checks whether an offset exists in the iterator.
offsetExists(mixed $offset) : boolean
since |
1.0 |
---|
Arguments
- $offset
mixed
The array offset.
Response
boolean
True if the offset exists, false otherwise.
offsetGet
Gets an offset in the iterator.
offsetGet(mixed $offset) : mixed
since |
1.0 |
---|
Arguments
- $offset
mixed
The array offset.
Response
mixed
The array value if it exists, null otherwise.
offsetSet
Sets an offset in the iterator.
offsetSet(mixed $offset, mixed $value) : void
since |
1.0 |
---|
Arguments
- $offset
mixed
The array offset.- $value
mixed
The array value.
offsetUnset
Unsets an offset in the iterator.
offsetUnset(mixed $offset) : void
since |
1.0 |
---|
Arguments
- $offset
mixed
The array offset.
remove
Delete a registry value
remove(string $path) : mixed
since |
1.6.0 |
---|
Arguments
- $path
string
Registry Path (e.g. joomla.content.showauthor)
Response
mixed
The value of the removed node or null if not set
set
Set a registry value.
set(string $path, mixed $value, string $separator = null) : mixed
since |
1.0 |
---|
Arguments
- $path
string
Registry Path (e.g. joomla.content.showauthor)- $value
mixed
Value of entry- $separator
string
The key separator
Response
mixed
The value of the that has been set.
toArray
Transforms a namespace to an array
toArray() : array
since |
1.0 |
---|
Response
array
An associative array holding the namespace data
toFlatten
Method to recursively convert data to one dimension array.
toFlatten(string $separator = null, array|object $data = null, array &$array = array(), string $prefix = '') : void
since |
1.3.0 |
---|
Arguments
- $separator
string
The key separator.- $data
array|object
Data source of this scope.- $array
array
The result array, it is passed by reference.- $prefix
string
Last level key prefix.
toObject
Transforms a namespace to an object
toObject() : object
since |
1.0 |
---|
Response
object
An an object holding the namespace data
toString
Get a namespace in a given string format
toString(string $format = 'JSON', mixed $options = array()) : string
since |
1.0 |
---|
Arguments
- $format
string
Format to return the string in- $options
mixed
Parameters used by the formatter, see formatters for more info
Response
string
Namespace in string format
Properties
data
Registry Object
since |
1.0 |
---|
Type(s)
\stdClass
initialized
Flag if the Registry data object has been initialized
since |
1.5.2 |
---|
Type(s)
boolean
instances
Registry instances container.
since |
1.0 |
---|---|
deprecated |
2.0 Object caching will no longer be supported |
Type(s)
array<mixed,\Joomla\Registry\Registry>
separator
Path separator
since |
1.4.0 |
---|
Type(s)
string