implements Phalcon\Mvc\EntityInterface, Phalcon\Mvc\CollectionInterface, Phalcon\Di\InjectionAwareInterface, Serializable
This component implements a high level abstraction for NoSQL databases which works with documents
Constants
integer OP_NONE
integer OP_CREATE
integer OP_UPDATE
integer OP_DELETE
Methods
final public __construct ([Phalcon\DiInterface $dependencyInjector], [Phalcon\Mvc\Collection\ManagerInterface $modelsManager])
Phalcon\Mvc\Collection constructor
public setId (mixed $id)
Sets a value for the _id property, creates a MongoId object if needed
public MongoId getId ()
Returns the value of the _id property
public setDI (Phalcon\DiInterface $dependencyInjector)
Sets the dependency injection container
public getDI ()
Returns the dependency injection container
protected setEventsManager (Phalcon\Mvc\Collection\ManagerInterface $eventsManager)
Sets a custom events manager
protected getEventsManager ()
Returns the custom events manager
public getCollectionManager ()
Returns the models manager related to the entity instance
public getReservedAttributes ()
Returns an array with reserved properties that cannot be part of the insert/update
protected useImplicitObjectIds (mixed $useImplicitObjectIds)
Sets if a model must use implicit objects ids
protected setSource (mixed $source)
Sets collection name which model should be mapped
public getSource ()
Returns collection name mapped in the model
public setConnectionService (mixed $connectionService)
Sets the DependencyInjection connection service name
public getConnectionService ()
Returns DependencyInjection connection service
public MongoDb getConnection ()
Retrieves a database connection
public mixed readAttribute (string $attribute)
Reads an attribute value by its name
echo $robot->readAttribute('name');
public writeAttribute (string $attribute, mixed $value)
Writes an attribute value by its name
$robot->writeAttribute('name', 'Rosey');
public static cloneResult (Phalcon\Mvc\CollectionInterface $collection, array $document)
Returns a cloned collection
protected static array _getResultset (array $params, Phalcon\Mvc\Collection $collection, MongoDb $connection, boolean $unique)
Returns a collection resultset
protected static int _getGroupResultset (array $params, Phalcon\Mvc\Collection $collection, MongoDb $connection)
Perform a count over a resultset
final protected boolean _preSave (Phalcon\DiInterface $dependencyInjector, boolean $disableEvents, boolean $exists)
Executes internal hooks before save a document
final protected _postSave (mixed $disableEvents, mixed $success, mixed $exists)
Executes internal events after save a document
protected validate (Phalcon\Mvc\Model\ValidatorInterface $validator)
Executes validators on every validation call
use Phalcon\Mvc\Model\Validator\ExclusionIn as ExclusionIn;
class Subscriptors extends \Phalcon\Mvc\Collection
{
public function validation()
{
this->validate(new ExclusionIn(array(
'field' => 'status',
'domain' => array('A', 'I')
)));
if (this->validationHasFailed() == true) {
return false;
}
}
}
public validationHasFailed ()
Check whether validation process has generated any messages
use Phalcon\Mvc\Model\Validator\ExclusionIn as ExclusionIn;
class Subscriptors extends \Phalcon\Mvc\Collection
{
public function validation()
{
this->validate(new ExclusionIn(array(
'field' => 'status',
'domain' => array('A', 'I')
)));
if (this->validationHasFailed() == true) {
return false;
}
}
}
public fireEvent (mixed $eventName)
Fires an internal event
public fireEventCancel (mixed $eventName)
Fires an internal event that cancels the operation
protected _cancelOperation (mixed $disableEvents)
Cancel the current operation
protected boolean _exists (MongoCollection $collection)
Checks if the document exists in the collection
public getMessages ()
Returns all the validation messages
$robot = new Robots();
$robot->type = 'mechanical';
$robot->name = 'Astro Boy';
$robot->year = 1952;
if ($robot->save() == false) {
echo "Umh, We can't store robots right now ";
foreach ($robot->getMessages() as message) {
echo message;
}
} else {
echo "Great, a new robot was saved successfully!";
}
public appendMessage (Phalcon\Mvc\Model\MessageInterface $message)
Appends a customized message on the validation process
use \Phalcon\Mvc\Model\Message as Message;
class Robots extends \Phalcon\Mvc\Model
{
public function beforeSave()
{
if ($this->name == 'Peter') {
message = new Message("Sorry, but a robot cannot be named Peter");
$this->appendMessage(message);
}
}
}
protected prepareCU ()
Shared Code for CU Operations Prepares Collection
public save ()
Creates/Updates a collection based on the values in the attributes
public create ()
Creates a collection based on the values in the attributes
public createIfNotExist (array $criteria)
Creates a document based on the values in the attributes, if not found by criteria Preferred way to avoid duplication is to create index on attribute $robot = new Robot(); $robot->name = “MyRobot”; $robot->type = “Droid”; //create only if robot with same name and type does not exist $robot->createIfNotExist( array( “name”, “type” ) );
public update ()
Creates/Updates a collection based on the values in the attributes
public static findById (mixed $id)
Find a document by its id (_id)
// Find user by using \MongoId object
$user = Users::findById(new \MongoId('545eb081631d16153a293a66'));
// Find user by using id as sting
$user = Users::findById('45cbc4a0e4123f6920000002');
// Validate input
if ($user = Users::findById($_POST['id'])) {
// ...
}
public static findFirst ([array $parameters])
Allows to query the first record that match the specified conditions
// What's the first robot in the robots table?
$robot = Robots::findFirst();
echo 'The robot name is ', $robot->name, "\n";
// What's the first mechanical robot in robots table?
$robot = Robots::findFirst([
['type' => 'mechanical']
]);
echo 'The first mechanical robot name is ', $robot->name, "\n";
// Get first virtual robot ordered by name
$robot = Robots::findFirst([
['type' => 'mechanical'],
'order' => ['name' => 1]
]);
echo 'The first virtual robot name is ', $robot->name, "\n";
// Get first robot by id (_id)
$robot = Robots::findFirst([
['_id' => new \MongoId('45cbc4a0e4123f6920000002')]
]);
echo 'The robot id is ', $robot->_id, "\n";
public static find ([array $parameters])
Allows to query a set of records that match the specified conditions
//How many robots are there?
$robots = Robots::find();
echo "There are ", count($robots), "\n";
//How many mechanical robots are there?
$robots = Robots::find(array(
array("type" => "mechanical")
));
echo "There are ", count(robots), "\n";
//Get and print virtual robots ordered by name
$robots = Robots::findFirst(array(
array("type" => "virtual"),
"order" => array("name" => 1)
));
foreach ($robots as $robot) {
echo $robot->name, "\n";
}
//Get first 100 virtual robots ordered by name
$robots = Robots::find(array(
array("type" => "virtual"),
"order" => array("name" => 1),
"limit" => 100
));
foreach ($robots as $robot) {
echo $robot->name, "\n";
}
public static count ([array $parameters])
Perform a count over a collection
echo 'There are ', Robots::count(), ' robots';
public static aggregate ([array $parameters])
Perform an aggregation using the Mongo aggregation framework
public static summatory (mixed $field, [mixed $conditions], [mixed $finalize])
Allows to perform a summatory group for a column in the collection
public delete ()
Deletes a model instance. Returning true on success or false otherwise.
$robot = Robots::findFirst();
$robot->delete();
foreach (Robots::find() as $robot) {
$robot->delete();
}
protected addBehavior (Phalcon\Mvc\Collection\BehaviorInterface $behavior)
Sets up a behavior in a collection
public skipOperation (mixed $skip)
Skips the current operation forcing a success state
public toArray ()
Returns the instance as an array representation
print_r($robot->toArray());
public serialize ()
Serializes the object ignoring connections or protected properties
public unserialize (mixed $data)
Unserializes the object from a serialized string
Please login to continue.