A registry is a container for storing objects and values in the application space.
By storing the value in a registry, the same object is always available throughout
<?php$registry=new\Phalcon\Registry();// Set value$registry->something="something";// or$registry["something"]="something";// Get value$value=$registry->something;// or$value=$registry["something"];// Check if the key exists$exists=isset($registry->something);// or$exists=isset($registry["something"]);// Unsetunset($registry->something);// orunset($registry["something"]);
In addition to ArrayAccess, Phalcon\Registry also implements Countable
(count($registry) will return the number of elements in the registry),
Serializable and Iterator (you can iterate over the registry
using a foreach loop) interfaces. For PHP 5.4 and higher, JsonSerializable
interface is implemented.
Phalcon\Registry is very fast (it is typically faster than any userspace
implementation of the registry); however, this comes at a price:
Phalcon\Registry is a final class and cannot be inherited from.
Though Phalcon\Registry exposes methods like __get(), offsetGet(), count() etc,
it is not recommended to invoke them manually (these methods exist mainly to
match the interfaces the registry implements): $registry->__get(“property”)
is several times slower than $registry->property.
Internally all the magic methods (and interfaces except JsonSerializable)
are implemented using object handlers or similar techniques: this allows
to bypass relatively slow method calls.
final public __construct ()
final public offsetExists (mixed $offset)
Checks if the element is present in the registry
final public offsetGet (mixed $offset)
Returns an index in the registry
final public offsetSet (mixed $offset, mixed $value)
Sets an element in the registry
final public offsetUnset (mixed $offset)
Unsets an element in the registry
final public count ()
Checks how many elements are in the register
final public next ()
Moves cursor to next row in the registry
final public key ()
Gets pointer number of active row in the registry
final public rewind ()
Rewinds the registry cursor to its beginning
public valid ()
Checks if the iterator is valid
public current ()
Obtains the current value in the internal iterator