Nested::validateValue() - Code Metrics - Inspection of "Validate nested data, add error details" - yiisoft/validator - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Pull Request — master (#151)

unknown
created 2022-01-27 06:33 UTC
Nested::validateValue() B

↳ Parent: Nested
Complexity

Conditions	9
Paths	10
Size

Total Lines	37
Code Lines	23
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	24
CRAP Score	9
Importance

Changes	1
Bugs	0	Features	0
Metric	Value
cc	9
eloc	23
nc	10
nop	2
dl	0
loc	37
ccs	24
cts	24
cp	1
crap	9
rs	8.0555
c	1
b	0
f	0
<?php

declare(strict_types=1);

namespace Yiisoft\Validator\Rule;

use InvalidArgumentException;
use Traversable;
use Yiisoft\Arrays\ArrayHelper;
use Yiisoft\Validator\ParametrizedRuleInterface;
use Yiisoft\Validator\Result;
use Yiisoft\Validator\Rule;
use Yiisoft\Validator\RuleInterface;
use Yiisoft\Validator\Rules;
use Yiisoft\Validator\ValidationContext;
use function is_array;
use function is_object;

/**
 * Nested rule can be used for validation of nested structures.
 *
 * For example we have an inbound request with the following structure:
 *
 * ```php
 * $request = [
 *     'author' => [
 *         'name' => 'Dmitry',
 *         'age' => 18,
 *     ],
 * ];
 * ```
 *
 * So to make validation with Nested rule we can configure it like this:
 *
 * ```php
 * $rule = Nested::rule([
 *     'author' => Nested::rule([
 *         'name' => [HasLength::rule()->min(3)],
 *         'age' => [Number::rule()->min(18)],
 *     )];
 * ]);
 * ```
 */
final class Nested extends Rule
{
    /**
     * @var Rule[][]
     */
    private iterable $rules;

    private bool $errorWhenPropertyPathIsNotFound = false;
    private string $propertyPathIsNotFoundMessage = 'Property path "{path}" is not found.';

    public static function rule(iterable $rules): self
    {
        $rules = $rules instanceof Traversable ? iterator_to_array($rules) : $rules;
        if (empty($rules)) {
            throw new InvalidArgumentException('Rules should not be empty.');
        }

        $rule = new self();
        if ($rule->checkRules($rules)) {
        if ($rule->checkRules(/** @scrutinizer ignore-type */ $rules)) {
            throw new InvalidArgumentException(sprintf(
                'Each rule should be an instance of %s.',
                RuleInterface::class
            ));
        }

        $rule->rules = $rules;
class Id
{
    public $id;

    public function __construct($id)
    {
        $this->id = $id;
    }

}

class Account
{
    /** @var  Id $id */
    public $id;
}

$account_id = false;

if (starsAreRight()) {
    $account_id = new Id(42);
}

$account = new Account();
if ($account instanceof Id)
{
    $account->id = $account_id;
}

        return $rule;
    }

    protected function validateValue($value, ValidationContext $context = null): Result
    {
        $result = new Result();
        if (!is_object($value) && !is_array($value)) {
            $result->addError(sprintf(
                'Value should be an array or an object. %s given.',
                gettype($value)
            ));
            return $result;
        }
        $value = (array) $value;

        foreach ($this->rules as $valuePath => $rules) {
            $rulesSet = is_array($rules) ? $rules : [$rules];
            if ($this->errorWhenPropertyPathIsNotFound && !ArrayHelper::pathExists($value, $valuePath)) {
                $result->addError(
                    $this->formatMessage(
                        $this->propertyPathIsNotFoundMessage,
                        [
                            'path' => $valuePath,
                        ]
                    )
                );
                continue;
            }
            $validatedValue = ArrayHelper::getValueByPath($value, $valuePath);
            $aggregatedRule = new Rules($rulesSet);
            $itemResult = $aggregatedRule->validate($validatedValue);
            if ($itemResult->isValid() === false) {
                foreach ($itemResult->getErrors() as $key => $error) {
                    $errorKey = self::calculateErrorKey($aggregatedRule, $valuePath, (string) $key);
                    $result->addError($error, $errorKey);
                }
            }
        }

        return $result;
    }

    /**
     * @param bool $value If absence of nested property should be considered an error. Default is `false`.
     *
     * @return self
     */
    public function errorWhenPropertyPathIsNotFound(bool $value): self
    {
        $new = clone $this;
        $new->errorWhenPropertyPathIsNotFound = $value;
        return $new;
    }

    /**
     * @param string $message A message to use when nested property is absent.
     *
     * @return $this
     */
    public function propertyPathIsNotFoundMessage(string $message): self
    {
        $new = clone $this;
        $new->propertyPathIsNotFoundMessage = $message;
        return $new;
    }

    public function getOptions(): array
    {
        return $this->fetchOptions($this->rules);
        return $this->fetchOptions(/** @scrutinizer ignore-type */ $this->rules);
    }

    private function checkRules(array $rules): bool
    {
        return array_reduce(
            $rules,
            fn (bool $carry, $rule) => $carry || (is_array($rule) ? $this->checkRules($rule) : !$rule instanceof RuleInterface),
            false
        );
    }

    private function fetchOptions(array $rules): array
    {
        $result = [];
        foreach ($rules as $attribute => $rule) {
            if (is_array($rule)) {
                $result[$attribute] = $this->fetchOptions($rule);
            } elseif ($rule instanceof ParametrizedRuleInterface) {
                $result[$attribute] = $rule->getOptions();
            } elseif ($rule instanceof RuleInterface) {
                // Just skip the rule that doesn't support parametrizing
            } else {
                throw new \InvalidArgumentException(sprintf(
                    'Rules should be an array of rules that implements %s.',
                    ParametrizedRuleInterface::class,
                ));
            }
        }

        return $result;
    }

    private static function calculateErrorKey(Rules $aggregatedRule, string $valuePath, string $key): string
    {
        if (!self::canConcatenateErrorKey($aggregatedRule, $key)) {
            return $valuePath;
        }

        return "$valuePath.$key";
    }

    private static function canConcatenateErrorKey(Rules $aggregatedRule, string $key): bool
    {
        if (!self::isPositiveInteger($key)) {
            return true;
        }

        $aggregatedRuleArray = $aggregatedRule->asArray();
        if (ArrayHelper::getValue($aggregatedRuleArray, [0, 0]) !== 'each') {
            return false;
        }

        return !(ArrayHelper::getValue($aggregatedRuleArray, [0, 1, 0]) === 'nested');
    }

    private static function isPositiveInteger(string $str): bool
    {
        if (!preg_match('/^\d$/', $str)) {
            return false;
        }

        return filter_var($str, FILTER_VALIDATE_INT, ['options' => ['min_range' => 0]]) !== false;
    }
}

yiisoft / validator

Pull Request — master (#151)

Nested::validateValue() B

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
