first

vendor/workerman/validation/library/Rules/AbstractRelated.php

@@ -0,0 +1,158 @@
+<?php
+
+/*
+ * This file is part of Respect/Validation.
+ *
+ * (c) Alexandre Gomes Gaigalas <alexandre@gaigalas.net>
+ *
+ * For the full copyright and license information, please view the LICENSE file
+ * that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Respect\Validation\Rules;
+
+use Respect\Validation\Exceptions\NestedValidationException;
+use Respect\Validation\Exceptions\ValidationException;
+use Respect\Validation\Validatable;
+
+use function is_scalar;
+
+/**
+ * @author Alexandre Gomes Gaigalas <alexandre@gaigalas.net>
+ * @author Emmerson Siqueira <emmersonsiqueira@gmail.com>
+ * @author Henrique Moody <henriquemoody@gmail.com>
+ * @author Nick Lombard <github@jigsoft.co.za>
+ */
+abstract class AbstractRelated extends AbstractRule
+{
+    /**
+     * @var bool
+     */
+    private $mandatory = true;
+
+    /**
+     * @var mixed
+     */
+    private $reference;
+
+    /**
+     * @var Validatable|null
+     */
+    private $rule;
+
+    /**
+     * @param mixed $input
+     */
+    abstract public function hasReference($input): bool;
+
+    /**
+     * @param mixed $input
+     *
+     * @return mixed
+     */
+    abstract public function getReferenceValue($input);
+
+    /**
+     * @param mixed $reference
+     */
+    public function __construct($reference, ?Validatable $rule = null, bool $mandatory = true)
+    {
+        $this->reference = $reference;
+        $this->rule = $rule;
+        $this->mandatory = $mandatory;
+
+        if ($rule && $rule->getName() !== null) {
+            $this->setName($rule->getName());
+        } elseif (is_scalar($reference)) {
+            $this->setName((string) $reference);
+        }
+    }
+
+    /**
+     * @return mixed
+     */
+    public function getReference()
+    {
+        return $this->reference;
+    }
+
+    public function isMandatory(): bool
+    {
+        return $this->mandatory;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function setName(string $name): Validatable
+    {
+        parent::setName($name);
+
+        if ($this->rule instanceof Validatable) {
+            $this->rule->setName($name);
+        }
+
+        return $this;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function assert($input): void
+    {
+        $hasReference = $this->hasReference($input);
+        if ($this->mandatory && !$hasReference) {
+            throw $this->reportError($input, ['hasReference' => false]);
+        }
+
+        if ($this->rule === null || !$hasReference) {
+            return;
+        }
+
+        try {
+            $this->rule->assert($this->getReferenceValue($input));
+        } catch (ValidationException $validationException) {
+            /** @var NestedValidationException $nestedValidationException */
+            $nestedValidationException = $this->reportError($this->reference, ['hasReference' => true]);
+            $nestedValidationException->addChild($validationException);
+
+            throw $nestedValidationException;
+        }
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function check($input): void
+    {
+        $hasReference = $this->hasReference($input);
+        if ($this->mandatory && !$hasReference) {
+            throw $this->reportError($input, ['hasReference' => false]);
+        }
+
+        if ($this->rule === null || !$hasReference) {
+            return;
+        }
+
+        $this->rule->check($this->getReferenceValue($input));
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function validate($input): bool
+    {
+        $hasReference = $this->hasReference($input);
+        if ($this->mandatory && !$hasReference) {
+            return false;
+        }
+
+        if ($this->rule === null || !$hasReference) {
+            return true;
+        }
+
+        return $this->rule->validate($this->getReferenceValue($input));
+    }
+}