Validate::addCrudValidation() - Code Metrics - Inspection of "improving typings" - zemit-cms/core - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — master ( 509678...44cd48 )

by Julien
created 2024-03-02 06:33 UTC
Validate::addCrudValidation() A

↳ Parent: Validate
Complexity

Conditions	4
Paths	6
Size

Total Lines	38
Code Lines	18
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	16
CRAP Score	4.3244
Importance

Changes
Metric	Value
eloc	18
dl	0
loc	38
ccs	16
cts	22
cp	0.7272
rs	9.6666
c	0
b	0
f	0
cc	4
nc	6
nop	4
crap	4.3244
<?php

/**
 * This file is part of the Zemit Framework.
 *
 * (c) Zemit Team <[email protected]>
 *
 * For the full copyright and license information, please view the LICENSE.txt
 * file that was distributed with this source code.
 */

namespace Zemit\Mvc\Model\Traits;

use Zemit\Db\Column;
use Zemit\Filter\Validation;
use Zemit\Filter\Validation\Validator\Color as ColorValidator;
use Zemit\Filter\Validation\Validator\Json as JsonValidator;
use Phalcon\Filter\Validation\Validator\Between;
use Phalcon\Filter\Validation\Validator\Date;
use Phalcon\Filter\Validation\Validator\Email;
use Phalcon\Filter\Validation\Validator\InclusionIn;
use Phalcon\Filter\Validation\Validator\Numericality;
use Phalcon\Filter\Validation\Validator\PresenceOf;
use Phalcon\Filter\Validation\Validator\StringLength\Max;
use Phalcon\Filter\Validation\Validator\StringLength\Min;
use Phalcon\Filter\Validation\Validator\Uniqueness;
use Zemit\Mvc\Model\Traits\Abstracts\AbstractEntity;
use Zemit\Mvc\Model\Traits\Abstracts\AbstractLocale;
use Zemit\Mvc\Model\Traits\Abstracts\AbstractMetaData;

trait Validate
{
    use AbstractLocale;
    use AbstractMetaData;
    use AbstractEntity;
    
    /**
     * Apply generic validation to a validator object.
     *
     * @param Validation|null $validator The validator object to apply the validation rules to. If null, a new Validation object will be created.
     *
     * @return Validation The validator object with the generic validation rules applied.
     */
    public function genericValidation(?Validation $validator = null): Validation
    {
        $validator ??= new Validation();
        
        $this->addPositionValidation($validator);
        $this->addSoftDeleteValidation($validator);
        $this->addCreatedValidation($validator);
        $this->addUpdatedValidation($validator);
        $this->addDeletedValidation($validator);
        $this->addRestoredValidation($validator);
        
        return $validator;
    }
    
    /**
     * Add validation to ensure that a field is not empty
     *
     * @param Validation $validator The validation object to add the validation to
     * @param array|string $field The name of the field to validate
     * @param bool $allowEmpty Whether to allow empty values. Default is false.
     * 
     * @return Validation The updated validation object
     */
    public function addNotEmptyValidation(Validation $validator, array|string $field, bool $allowEmpty = false): Validation
    {
        if (!$allowEmpty) {
            $this->addPresenceValidation($validator, $field, $allowEmpty);
        }
        
        return $validator;
    }
    
    /**
     * Add presence validation to a field in a validator object
     *
     * @param Validation $validator The validator object to add the validation to
     * @param array|string $field The name of the field to validate
     * @param bool $allowEmpty Whether to allow empty values for the field or not (default: true)
     *
     * @return Validation The modified validator object after adding the validation
     */
    public function addPresenceValidation(Validation $validator, array|string $field, bool $allowEmpty = true): Validation
    {
        $validator->add($field, new PresenceOf([
            'message' => $this->_('required'),
            'allowEmpty' => $allowEmpty,
        ]));
        
        return $validator;
    }
    
    /**
     * Add validations for an unsigned integer field
     *
     * @param Validation $validator The validation object to add rules to
     * @param array|string $field The name of the field to validate (default: 'id')
     * @param bool $allowEmpty Whether to allow the field to be empty (default: true)
     *
     * @return Validation The updated validation object with the added rules
     */
    public function addUnsignedIntValidation(Validation $validator, array|string $field = 'id', bool $allowEmpty = true): Validation
    {
        $this->addNotEmptyValidation($validator, $field, $allowEmpty);
        
        // Must be numeric
        $validator->add($field, new Numericality([
            'message' => $this->_('not-numeric'),
            'allowEmpty' => true,
        ]));
        
        // Must be an unsigned integer
        $validator->add($field, new Between([
            'minimum' => Column::MIN_UNSIGNED_INT,
            'maximum' => Column::MAX_UNSIGNED_INT,
            'message' => $this->_('not-an-unsigned-integer'),
            'allowEmpty' => true,
        ]));
        
        return $validator;
    }
    
    /**
     * Add basic validations for the specified field to ensure it is an unsigned big integer
     *
     * @param Validation $validator The validation object to add rules to
     * @param array|string $field The name of the field to validate (default is 'id')
     * @param bool $allowEmpty Whether empty values are allowed or not (default is true)
     * 
     * @return Validation The updated validation object
     */
    public function addUnsignedBigIntValidation(Validation $validator, array|string $field = 'id', bool $allowEmpty = true): Validation
    {
        $this->addNotEmptyValidation($validator, $field, $allowEmpty);
        
        // Must be numeric
        $validator->add($field, new Numericality([
            'message' => $this->_('not-numeric'),
            'allowEmpty' => true,
        ]));
        
        // Must be an unsigned integer
        $validator->add($field, new Between([
            'minimum' => Column::MIN_UNSIGNED_BIGINT,
            'maximum' => Column::MAX_UNSIGNED_BIGINT,
            'message' => $this->_('not-an-unsigned-big-integer'),
            'allowEmpty' => true,
        ]));
        
        return $validator;
    }
    
    /**
     * Add number validations for a given field
     *
     * @param Validation $validator The validation object to add the validations to
     * @param array|string $field The name of the field to validate
     * @param int $min The minimum value allowed for the field
     * @param int $max The maximum value allowed for the field
     * @param bool $allowEmpty Specifies whether the field can be empty
     * 
     * @return Validation The modified validation object with the number validations added
     */
    public function addNumberValidation(Validation $validator, array|string $field, int $min, int $max, bool $allowEmpty = true): Validation
    {
        $this->addNotEmptyValidation($validator, $field, $allowEmpty);
        
        // Must be numeric
        $validator->add($field, new Numericality([
            'message' => $this->_('not-numeric'),
            'allowEmpty' => true,
        ]));
        
        // Must be an unsigned integer
        $validator->add($field, new Between([
            'minimum' => $min,
            'maximum' => $max,
            'message' => $this->_('not-between'),
            'allowEmpty' => true,
        ]));
        
        return $validator;
    }
    
    /**
     * Add string length validations for a field
     *
     * @param Validation $validator The validation object to add the validations to
     * @param array|string $field The name of the field to be validated
     * @param int $minChar The minimum number of characters allowed (default: 0)
     * @param int $maxChar The maximum number of characters allowed (default: 255)
     * @param bool $allowEmpty Whether empty values are allowed (default: true)
     *
     * @return Validation The validation object with the added validations
     */
    public function addStringLengthValidation(Validation $validator, array|string $field, int $minChar = 0, int $maxChar = 255, bool $allowEmpty = true): Validation
    {
        $this->addNotEmptyValidation($validator, $field, $allowEmpty);
        
        $validator->add($field, new Min([
            'min' => $minChar,
            'message' => $this->_('min-length'),
            'allowEmpty' => true,
        ]));
        
        $validator->add($field, new Max([
            'max' => $maxChar,
            'message' => $this->_('max-length'),
            'allowEmpty' => true,
        ]));
        
        return $validator;
    }
    
    /**
     * Add inclusion validation for a field
     *
     * @param Validation $validator The validation object
     * @param array|string $field The name of the field to be validated
     * @param array $domainList The list of valid values for the field
     * @param bool $allowEmpty Set to true to allow empty values (default: true)
     *
     * @return Validation The updated validation object with the inclusion validation added
     */
    public function addInclusionInValidation(Validation $validator, array|string $field, array $domainList = [], bool $allowEmpty = true): Validation
    {
        $this->addNotEmptyValidation($validator, $field, $allowEmpty);
        
        $validator->add($field, new InclusionIn([
            'message' => $this->_('not-valid'),
            'domain' => $domainList,
            'allowEmpty' => true,
        ]));
        
        return $validator;
    }
    
    /**
     * Add basic validations for a boolean field
     * - Must not be empty
     * - Must be a boolean value (1, 0, true, false)
     *
     * @param Validation $validator The validation object to add the validations to
     * @param array|string $field The name of the field to validate
     * @param bool $allowEmpty Whether to allow empty values or not (default: true)
     *
     * @return Validation The updated validation object
     */
    public function addBooleanValidation(Validation $validator, array|string $field, bool $allowEmpty = true): Validation
    {
        $this->addNotEmptyValidation($validator, $field, $allowEmpty);
        
        $validator->add($field, new InclusionIn([
            'message' => $this->_('not-boolean'),
            'domain' => [1, 0, true, false],
            'allowEmpty' => true,
        ]));
        
        return $validator;
    }
    
    /**
     * Add inclusion validation for a specified field
     *
     * This method adds an inclusion validation rule to the given validator object for the specified field.
     * The inclusion rule checks if the value of the field is included in the specified domain.
     *
     * @param Validation $validator The validator object to which the rule should be added
     * @param array|string $field The name of the field to be validated
     * @param array $domain The array of allowed values for the field
     * @param bool $allowEmpty Whether to allow empty values for the field (default: true)
     * @param bool $strict Whether to use strict comparison for checking inclusion (default: true)
     * 
     * @return Validation The updated validator object
     */
    public function addInclusionValidation(Validation $validator, array|string $field, array $domain = [], bool $allowEmpty = true, bool $strict = true): Validation
    {
        $this->addNotEmptyValidation($validator, $field, $allowEmpty);
        
        $validator->add($field, new InclusionIn([
            'message' => $this->_('not-valid'),
            'domain' => $domain,
            'strict' => $strict,
            'allowEmpty' => true,
        ]));
        
        return $validator;
    }
    
    /**
     * Add uniqueness validation for the specified field(s)
     *
     * @param Validation $validator The validation object to add the validation rules to
     * @param string|array $field The field(s) to apply the uniqueness validation to
     * @param bool $allowEmpty Whether to allow empty values for the field(s)
     * 
     * @return Validation The modified validation object
     */
    public function addUniquenessValidation(Validation $validator, string|array $field, bool $allowEmpty = true): Validation
    {
        $this->addNotEmptyValidation($validator, $field, $allowEmpty);
        
        $validator->add($field, new Uniqueness([
            'message' => $this->_('not-unique'),
            'allowEmpty' => true,
        ]));
        
        return $validator;
    }
    
    /**
     * Add email validation to a field
     *
     * @param Validation $validator The validator object
     * @param array|string $field The field name to add the validation to
     * @param bool $allowEmpty Whether to allow empty values for the field (default: true)
     * 
     * @return Validation The modified validator object
     */
    public function addEmailValidation(Validation $validator, array|string $field, bool $allowEmpty = true): Validation
    {
        $this->addNotEmptyValidation($validator, $field, $allowEmpty);
        
        $validator->add($field, new Email([
            'message' => $this->_('invalid-email'),
            'allowEmpty' => true,
        ]));
        
        return $validator;
    }
    
    /**
     * Add basic validations for the date field
     * - Must not be empty
     * - Must be a valid date in the specified format
     *
     * @param Validation $validator The validation object to add the validations to
     * @param array|string $field The name of the date field to validate
     * @param bool $allowEmpty Whether to allow empty values for the date field (default: true)
     * @param string $format The expected format of the date field (default: Column::DATE_FORMAT)
     * 
     * @return Validation The updated validation object
     */
    public function addDateValidation(Validation $validator, array|string $field, bool $allowEmpty = true, string $format = Column::DATE_FORMAT): Validation
    {
        $this->addNotEmptyValidation($validator, $field, $allowEmpty);
        
        $validator->add($field, new Date([
            'format' => $format,
            'message' => $this->_('invalid-date-format'),
            'allowEmpty' => true,
        ]));
        
        return $validator;
    }
    
    /**
     * Add basic validations for the datetime field
     * - Must not be empty
     * - Must be a valid datetime format
     *
     * @param Validation $validator The validation object
     * @param array|string $field The name of the field to validate
     * @param bool $allowEmpty Specifies if the field is allowed to be empty (default: true)
     * @param string $format The format of the datetime (default: Column::DATETIME_FORMAT)
     * 
     * @return Validation The updated validation object
     */
    public function addDateTimeValidation(Validation $validator, array|string $field, bool $allowEmpty = true, string $format = Column::DATETIME_FORMAT): Validation
    {
        $this->addNotEmptyValidation($validator, $field, $allowEmpty);
        
        $validator->add($field, new Date([
            'format' => $format,
            'message' => $this->_('invalid-date-format'),
            'allowEmpty' => true,
        ]));
        
        return $validator;
    }
    
    /**
     * Add validations for a JSON field
     * - Must not be empty (unless allowEmpty is set to true)
     * - Must be a valid JSON string
     *
     * @param Validation $validator The validator object to add the validations to
     * @param array|string $field The name of the JSON field to validate
     * @param bool $allowEmpty Whether to allow an empty value for the field
     * @param int $depth The maximum depth of the JSON string (default: 512)
     * @param int $flags JSON flags to be used (default: 0)
     * 
     * @return Validation The updated validator object
     */
    public function addJsonValidation(Validation $validator, array|string $field, bool $allowEmpty = true, int $depth = 512, int $flags = 0): Validation
    {
        $this->addNotEmptyValidation($validator, $field, $allowEmpty);
        
        $validator->add($field, new JsonValidator([
            'message' => $this->_('not-valid-json'),
            'depth' => $depth,
            'flags' => $flags,
            'allowEmpty' => true,
        ]));
        
        return $validator;
    }
    
    /**
     * Add basic validations for the color field
     * - Must not be empty (unless $allowEmpty is set to true)
     * - Must be a valid hex color code
     *
     * @param Validation $validator The validation object
     * @param array|string $field The name of the field to validate
     * @param bool $allowEmpty Whether empty values are allowed (default: true)
     * 
     * @return Validation The modified validation object
     */
    public function addColorValidation(Validation $validator, array|string $field, bool $allowEmpty = true): Validation
    {
        $this->addNotEmptyValidation($validator, $field, $allowEmpty);
        
        $validator->add($field, new ColorValidator([
            'message' => $this->_('not-hex-color'),
            'allowEmpty' => true,
        ]));
        
        return $validator;
    }
    
    /**
     * Add basic validations for the id field
     * - Must be an unsigned integer
     *
     * @param Validation $validator The validation object to add validation rules to
     * @param string $field The name of the field to add validations for (default: 'id')
     * 
     * @return Validation The updated validation object
     */
    public function addIdValidation(Validation $validator, string $field = 'id'): Validation
    {
        if (property_exists($this, $field)) {
            $this->addUnsignedIntValidation($validator, $field);
        }
        
        return $validator;
    }
    
    /**
     * Add position validation to a validator object.
     *
     * @param Validation $validator The validator object to add the validation rules to.
     * @param string $field The field name to apply the validation rules to. Default is 'position'.
     * @param bool $allowEmpty Whether empty values are allowed. Default is true.
     *
     * @return Validation The updated validator object with the position validation added.
     */
    public function addPositionValidation(Validation $validator, string $field = 'position', bool $allowEmpty = true): Validation
    {
        if (property_exists($this, $field)) {
            
            $this->addNotEmptyValidation($validator, $field, $allowEmpty);
            
            // Must be numeric
            $validator->add($field, new Numericality([
                'message' => $this->_('not-numeric'),
                'allowEmpty' => true,
            ]));
            
            // Must be an unsigned integer
            $validator->add($field, new Between([
                'minimum' => Column::MIN_UNSIGNED_INT,
                'maximum' => Column::MAX_UNSIGNED_INT,
                'message' => $this->_('not-an-unsigned-integer'),
                'allowEmpty' => true,
            ]));
        }
        
        return $validator;
    }
    
    /**
     * Add soft delete validation to a validator object.
     *
     * @param Validation $validator The validator object to add the validation rules to.
     * @param string $field The field name to apply the validation rules to. Default is 'deleted'.
     * @param bool $allowEmpty Whether empty values are allowed. Default is true.
     *
     * @return Validation The updated validator object with the soft delete validation added.
     */
    public function addSoftDeleteValidation(Validation $validator, string $field = 'deleted', bool $allowEmpty = true): Validation
    {
        if (property_exists($this, $field)) {
            
            $this->addNotEmptyValidation($validator, $field, $allowEmpty);
            
            // Must be YES or NO
            $validator->add($field, new InclusionIn([
                'message' => $this->_('not-valid'),
                'domain' => [Column::YES, Column::NO],
                'strict' => true,
            ]));
            
            // Must be numeric
            $validator->add($field, new Numericality([
                'message' => $this->_('not-numeric'),
                'allowEmpty' => true,
            ]));
        }
        
        return $validator;
    }
    
    /**
     * Add UUID validation to a validator object.
     *
     * @param Validation $validator The validator object to add the validation rules to.
     * @param string $field The field name to apply the validation rules to. Default is 'uuid'.
     * @param bool $allowEmpty Whether empty values are allowed. Default is false.
     *
     * @return Validation The updated validator object with the UUID validation added.
     */
    public function addUuidValidation(Validation $validator, string $field = 'uuid', bool $allowEmpty = false): Validation
    {
        if (property_exists($this, $field) && $this->getModelsMetaData()->hasAttribute($this, $field)) {
        if (property_exists($this, $field) && $this->getModelsMetaData()->hasAttribute(/** @scrutinizer ignore-type */ $this, $field)) {
            
            $this->addNotEmptyValidation($validator, $field, $allowEmpty);
            
            // Must be unique
            $validator->add($field, new Uniqueness([
                'message' => $this->_('not-unique'),
                'allowEmpty' => true,
            ]));
        }
        
        return $validator;
    }
    
    /**
     * Add CRUD validation to a validator object.
     *
     * @param Validation $validator The validator object to add the validation rules to.
     * @param string $userIdField The field name for the user ID validation rules.
     * @param string $dateField The field name for the date validation rules.
     * @param bool $allowEmpty Whether empty values are allowed. Default is true.
     *
     * @return Validation The updated validator object with the CRUD validation added.
     */
    public function addCrudValidation(Validation $validator, string $userIdField, string $dateField, bool $allowEmpty = true): Validation
    {
        if (property_exists($this, $userIdField)) {
            
            $this->addNotEmptyValidation($validator, $userIdField, $allowEmpty);
            
            // Must be numeric
            $validator->add($userIdField, new Numericality([
                'message' => $this->_('not-numeric'),
                'allowEmpty' => true,
            ]));
            
            // Must be an unsigned integer
            $validator->add($userIdField, new Between([
                'minimum' => Column::MIN_UNSIGNED_INT,
                'maximum' => Column::MAX_UNSIGNED_INT,
                'message' => $this->_('not-an-unsigned-integer'),
                'allowEmpty' => true,
            ]));
        }
        
        if (property_exists($this, $dateField)) {
            
            // if the $userIdField is filled
            if (!empty($this->readAttribute($userIdField))) {
                
                $this->addPresenceValidation($validator, $dateField, false);
                
                // Must be a valid date format
                $validator->add($dateField, new Date([
                    'format' => Column::DATETIME_FORMAT,
                    'message' => $this->_('invalid-date-format'),
                    'allowEmpty' => true,
                ]));
            }
        }
        
        return $validator;
    }
    
    /**
     * Add created validation to a validator object.
     *
     * @param Validation $validator The validator object to add the validation rules to.
     * @param string $createdByField The field name to apply the validation rules for the "created by" user. Default is 'createdBy'.
     * @param string $createdAtField The field name to apply the validation rules for the "created at" timestamp. Default is 'createdAt'.
     * @param bool $allowEmpty Whether empty values are allowed. Default is true.
     *
     * @return Validation The updated validator object with the created validation added.
     */
    public function addCreatedValidation(Validation $validator, string $createdByField = 'createdBy', string $createdAtField = 'createdAt', bool $allowEmpty = true): Validation
    {
        return $this->addCrudValidation($validator, $createdByField, $createdAtField, $allowEmpty);
    }
    
    /**
     * Add updated validation to a validator object.
     *
     * @param Validation $validator The validator object to add the validation rules to.
     * @param string $updatedByField The field name to apply the updated by validation rule to. Default is 'updatedBy'.
     * @param string $updatedAtField The field name to apply the updated at validation rule to. Default is 'updatedAt'.
     * @param bool $allowEmpty Whether empty values are allowed. Default is true.
     *
     * @return Validation The updated validator object with the updated validation added.
     */
    public function addUpdatedValidation(Validation $validator, string $updatedByField = 'updatedBy', string $updatedAtField = 'updatedAt', bool $allowEmpty = true): Validation
    {
        return $this->addCrudValidation($validator, $updatedByField, $updatedAtField, $allowEmpty);
    }
    
    /**
     * Add deleted validation to a validator object.
     *
     * @param Validation $validator The validator object to add the validation rules to.
     * @param string $deletedField The field name to apply the validation rules to for deleted user. Default is 'deletedBy'.
     * @param string $dateField The field name to apply the validation rules to for deletion date. Default is 'deletedAt'.
     * @param bool $allowEmpty Whether empty values are allowed. Default is true.
     *
     * @return Validation The updated validator object with the deleted validation added.
     */
    public function addDeletedValidation(Validation $validator, string $deletedField = 'deletedBy', string $dateField = 'deletedAt', bool $allowEmpty = true): Validation
    {
        return $this->addCrudValidation($validator, $deletedField, $dateField, $allowEmpty);
    }
    
    /**
     * Add restored validation to a validator object.
     *
     * @param Validation $validator The validator object to add the validation rules to.
     * @param string $restoredByField The field name for the restored by information. Default is 'restoredBy'.
     * @param string $restoredAtField The field name for the restored at information. Default is 'restoredAt'.
     * @param bool $allowEmpty Whether empty values are allowed. Default is true.
     *
     * @return Validation The updated validator object with the restored validation added.
     */
    public function addRestoredValidation(Validation $validator, string $restoredByField = 'restoredBy', string $restoredAtField = 'restoredAt', bool $allowEmpty = true): Validation
    {
        return $this->addCrudValidation($validator, $restoredByField, $restoredAtField, $allowEmpty);
    }
}

zemit-cms / core

Push — master ( 509678...44cd48 )

Validate::addCrudValidation() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
