Class **Phalcon\\Mvc\\Model\\Validator\\Uniqueness**
====================================================

*extends* abstract class :doc:`Phalcon\\Mvc\\Model\\Validator <Phalcon_Mvc_Model_Validator>`

*implements* :doc:`Phalcon\\Mvc\\Model\\ValidatorInterface <Phalcon_Mvc_Model_ValidatorInterface>`

.. role:: raw-html(raw)
   :format: html

:raw-html:`<a href="https://github.com/phalcon/cphalcon/blob/master/phalcon/mvc/model/validator/uniqueness.zep" class="btn btn-default btn-sm">Source on GitHub</a>`

Validates that a field or a combination of a set of fields are not
present more than once in the existing records of the related table

This validator is only for use with Phalcon\\Mvc\\Collection. If you are using
Phalcon\\Mvc\\Model, please use the validators provided by Phalcon\\Validation.

.. code-block:: php

    <?php

    use Phalcon\Mvc\Collection;
    use Phalcon\Mvc\Model\Validator\Uniqueness;

    class Subscriptors extends Collection
    {
        public function validation()
        {
            $this->validate(
                new Uniqueness(
                    [
                        "field"   => "email",
                        "message" => "Value of field 'email' is already present in another record",
                    ]
                )
            );

            if ($this->validationHasFailed() === true) {
                return false;
            }
        }
    }



Methods
-------

public  **validate** (:doc:`Phalcon\\Mvc\\EntityInterface <Phalcon_Mvc_EntityInterface>` $record)

Executes the validator



public  **__construct** (*array* $options) inherited from :doc:`Phalcon\\Mvc\\Model\\Validator <Phalcon_Mvc_Model_Validator>`

Phalcon\\Mvc\\Model\\Validator constructor



protected  **appendMessage** (*string* $message, [*string* | *array* $field], [*string* $type]) inherited from :doc:`Phalcon\\Mvc\\Model\\Validator <Phalcon_Mvc_Model_Validator>`

Appends a message to the validator



public  **getMessages** () inherited from :doc:`Phalcon\\Mvc\\Model\\Validator <Phalcon_Mvc_Model_Validator>`

Returns messages generated by the validator



public *array* **getOptions** () inherited from :doc:`Phalcon\\Mvc\\Model\\Validator <Phalcon_Mvc_Model_Validator>`

Returns all the options from the validator



public  **getOption** (*mixed* $option, [*mixed* $defaultValue]) inherited from :doc:`Phalcon\\Mvc\\Model\\Validator <Phalcon_Mvc_Model_Validator>`

Returns an option



public  **isSetOption** (*mixed* $option) inherited from :doc:`Phalcon\\Mvc\\Model\\Validator <Phalcon_Mvc_Model_Validator>`

Check whether an option has been defined in the validator options