Abstract class Phalcon\Mvc\Collection

implements Phalcon\Mvc\EntityInterface, Phalcon\Mvc\CollectionInterface, Phalcon\Di\InjectionAwareInterface, Serializable

Source on GitHub

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

integer DIRTY_STATE_PERSISTENT

integer DIRTY_STATE_TRANSIENT

integer DIRTY_STATE_DETACHED

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

  1. <?php
  3. echo $robot->readAttribute("name");

public writeAttribute (string $attribute, mixed $value)

Writes an attribute value by its name

  1. <?php
  3. $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 (mixed $validator)

Executes validators on every validation call

  1. <?php
  3. use Phalcon\Mvc\Model\Validator\ExclusionIn as ExclusionIn;
  5. class Subscriptors extends \Phalcon\Mvc\Collection
  6. {
  7.     public function validation()
  8.     {
  9.         // Old, deprecated syntax, use new one below
  10.         $this->validate(
  11.             new ExclusionIn(
  12.                 [
  13.                     "field"  => "status",
  14.                     "domain" => ["A", "I"],
  15.                 ]
  16.             )
  17.         );
  19.         if ($this->validationHasFailed() == true) {
  20.             return false;
  21.         }
  22.     }
  23. }
  1. <?php
  3. use Phalcon\Validation\Validator\ExclusionIn as ExclusionIn;
  4. use Phalcon\Validation;
  6. class Subscriptors extends \Phalcon\Mvc\Collection
  7. {
  8.     public function validation()
  9.     {
  10.         $validator = new Validation();
  11.         $validator->add("status",
  12.             new ExclusionIn(
  13.                 [
  14.                     "domain" => ["A", "I"]
  15.                 ]
  16.             )
  17.         );
  19.         return $this->validate($validator);
  20.     }
  21. }

public validationHasFailed ()

Check whether validation process has generated any messages

  1. <?php
  3. use Phalcon\Mvc\Model\Validator\ExclusionIn as ExclusionIn;
  5. class Subscriptors extends \Phalcon\Mvc\Collection
  6. {
  7.     public function validation()
  8.     {
  9.         $this->validate(
  10.             new ExclusionIn(
  11.                 [
  12.                     "field"  => "status",
  13.                     "domain" => ["A", "I"],
  14.                 ]
  15.             )
  16.         );
  18.         if ($this->validationHasFailed() == true) {
  19.             return false;
  20.         }
  21.     }
  22. }

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

  1. <?php
  3. $robot = new Robots();
  5. $robot->type = "mechanical";
  6. $robot->name = "Astro Boy";
  7. $robot->year = 1952;
  9. if ($robot->save() === false) {
  10.     echo "Umh, We can't store robots right now ";
  12.     $messages = $robot->getMessages();
  14.     foreach ($messages as $message) {
  15.         echo $message;
  16.     }
  17. } else {
  18.     echo "Great, a new robot was saved successfully!";
  19. }

public appendMessage (Phalcon\Mvc\Model\MessageInterface $message)

Appends a customized message on the validation process

  1. <?php
  3. use \Phalcon\Mvc\Model\Message as Message;
  5. class Robots extends \Phalcon\Mvc\Model
  6. {
  7.     public function beforeSave()
  8.     {
  9.         if ($this->name === "Peter") {
  10.             $message = new Message(
  11.                 "Sorry, but a robot cannot be named Peter"
  12.             );
  14.             $this->appendMessage(message);
  15.         }
  16.     }
  17. }

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

  1. <?php
  3. $robot = new Robot();
  5. $robot->name = "MyRobot";
  6. $robot->type = "Droid";
  8. // Create only if robot with same name and type does not exist
  9. $robot->createIfNotExist(
  10.     [
  11.         "name",
  12.         "type",
  13.     ]
  14. );

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)

  1. <?php
  3. // Find user by using \MongoId object
  4. $user = Users::findById(
  5.     new \MongoId("545eb081631d16153a293a66")
  6. );
  8. // Find user by using id as sting
  9. $user = Users::findById("45cbc4a0e4123f6920000002");
  11. // Validate input
  12. if ($user = Users::findById($_POST["id"])) {
  13.     // ...
  14. }

public static findFirst ([array $parameters])

Allows to query the first record that match the specified conditions

  1. <?php
  3. // What's the first robot in the robots table?
  4. $robot = Robots::findFirst();
  6. echo "The robot name is ", $robot->name, "\n";
  8. // What's the first mechanical robot in robots table?
  9. $robot = Robots::findFirst(
  10.     [
  11.         [
  12.             "type" => "mechanical",
  13.         ]
  14.     ]
  15. );
  17. echo "The first mechanical robot name is ", $robot->name, "\n";
  19. // Get first virtual robot ordered by name
  20. $robot = Robots::findFirst(
  21.     [
  22.         [
  23.             "type" => "mechanical",
  24.         ],
  25.         "order" => [
  26.             "name" => 1,
  27.         ],
  28.     ]
  29. );
  31. echo "The first virtual robot name is ", $robot->name, "\n";
  33. // Get first robot by id (_id)
  34. $robot = Robots::findFirst(
  35.     [
  36.         [
  37.             "_id" => new \MongoId("45cbc4a0e4123f6920000002"),
  38.         ]
  39.     ]
  40. );
  42. 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

  1. <?php
  3. // How many robots are there?
  4. $robots = Robots::find();
  6. echo "There are ", count($robots), "\n";
  8. // How many mechanical robots are there?
  9. $robots = Robots::find(
  10.     [
  11.         [
  12.             "type" => "mechanical",
  13.         ]
  14.     ]
  15. );
  17. echo "There are ", count(robots), "\n";
  19. // Get and print virtual robots ordered by name
  20. $robots = Robots::findFirst(
  21.     [
  22.         [
  23.             "type" => "virtual"
  24.         ],
  25.         "order" => [
  26.             "name" => 1,
  27.         ]
  28.     ]
  29. );
  31. foreach ($robots as $robot) {
  32.    echo $robot->name, "\n";
  33. }
  35. // Get first 100 virtual robots ordered by name
  36. $robots = Robots::find(
  37.     [
  38.         [
  39.             "type" => "virtual",
  40.         ],
  41.         "order" => [
  42.             "name" => 1,
  43.         ],
  44.         "limit" => 100,
  45.     ]
  46. );
  48. foreach ($robots as $robot) {
  49.    echo $robot->name, "\n";
  50. }

public static count ([array $parameters])

Perform a count over a collection

  1. <?php
  3. 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.

  1. <?php
  3. $robot = Robots::findFirst();
  5. $robot->delete();
  7. $robots = Robots::find();
  9. foreach ($robots as $robot) {
  10.     $robot->delete();
  11. }

public setDirtyState (mixed $dirtyState)

Sets the dirty state of the object using one of the DIRTY_STATE_* constants

public getDirtyState ()

Returns one of the DIRTY_STATE_* constants telling if the document exists in the collection or not

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

  1. <?php
  3. print_r(
  4.     $robot->toArray()
  5. );

public serialize ()

Serializes the object ignoring connections or protected properties

public unserialize (mixed $data)

Unserializes the object from a serialized string