Upgrade framework

vendor/vlucas/phpdotenv/src/Validator.php

@@ -1,46 +1,57 @@
 <?php
 
+declare(strict_types=1);
+
 namespace Dotenv;
 
-use Dotenv\Exception\InvalidCallbackException;
 use Dotenv\Exception\ValidationException;
+use Dotenv\Repository\RepositoryInterface;
+use Dotenv\Util\Regex;
+use Dotenv\Util\Str;
 
-/**
- * This is the validator class.
- *
- * It's responsible for applying validations against a number of variables.
- */
 class Validator
 {
     /**
-     * The variables to validate.
+     * The environment repository instance.
      *
-     * @var array
+     * @var \Dotenv\Repository\RepositoryInterface
      */
-    protected $variables;
+    private $repository;
 
     /**
-     * The loader instance.
+     * The variables to validate.
      *
-     * @var \Dotenv\Loader
+     * @var string[]
      */
-    protected $loader;
+    private $variables;
 
     /**
      * Create a new validator instance.
      *
-     * @param array          $variables
-     * @param \Dotenv\Loader $loader
+     * @param \Dotenv\Repository\RepositoryInterface $repository
+     * @param string[]                               $variables
+     *
+     * @throws \Dotenv\Exception\ValidationException
      *
      * @return void
      */
-    public function __construct(array $variables, Loader $loader)
+    public function __construct(RepositoryInterface $repository, array $variables)
     {
+        $this->repository = $repository;
         $this->variables = $variables;
-        $this->loader = $loader;
+    }
 
-        $this->assertCallback(
-            function ($value) {
+    /**
+     * Assert that each variable is present.
+     *
+     * @throws \Dotenv\Exception\ValidationException
+     *
+     * @return \Dotenv\Validator
+     */
+    public function required()
+    {
+        return $this->assert(
+            static function (?string $value) {
                 return $value !== null;
             },
             'is missing'
@@ -50,13 +61,15 @@ class Validator
     /**
      * Assert that each variable is not empty.
      *
+     * @throws \Dotenv\Exception\ValidationException
+     *
      * @return \Dotenv\Validator
      */
     public function notEmpty()
     {
-        return $this->assertCallback(
-            function ($value) {
-                return strlen(trim($value)) > 0;
+        return $this->assertNullable(
+            static function (string $value) {
+                return Str::len(\trim($value)) > 0;
             },
             'is empty'
         );
@@ -65,66 +78,132 @@ class Validator
     /**
      * Assert that each specified variable is an integer.
      *
+     * @throws \Dotenv\Exception\ValidationException
+     *
      * @return \Dotenv\Validator
      */
     public function isInteger()
     {
-        return $this->assertCallback(
-            function ($value) {
-                return ctype_digit($value);
+        return $this->assertNullable(
+            static function (string $value) {
+                return \ctype_digit($value);
             },
             'is not an integer'
         );
     }
 
+    /**
+     * Assert that each specified variable is a boolean.
+     *
+     * @throws \Dotenv\Exception\ValidationException
+     *
+     * @return \Dotenv\Validator
+     */
+    public function isBoolean()
+    {
+        return $this->assertNullable(
+            static function (string $value) {
+                if ($value === '') {
+                    return false;
+                }
+
+                return \filter_var($value, \FILTER_VALIDATE_BOOLEAN, \FILTER_NULL_ON_FAILURE) !== null;
+            },
+            'is not a boolean'
+        );
+    }
+
     /**
      * Assert that each variable is amongst the given choices.
      *
      * @param string[] $choices
      *
+     * @throws \Dotenv\Exception\ValidationException
+     *
      * @return \Dotenv\Validator
      */
     public function allowedValues(array $choices)
     {
-        return $this->assertCallback(
-            function ($value) use ($choices) {
-                return in_array($value, $choices);
+        return $this->assertNullable(
+            static function (string $value) use ($choices) {
+                return \in_array($value, $choices, true);
             },
-            'is not an allowed value'
+            \sprintf('is not one of [%s]', \implode(', ', $choices))
+        );
+    }
+
+    /**
+     * Assert that each variable matches the given regular expression.
+     *
+     * @param string $regex
+     *
+     * @throws \Dotenv\Exception\ValidationException
+     *
+     * @return \Dotenv\Validator
+     */
+    public function allowedRegexValues(string $regex)
+    {
+        return $this->assertNullable(
+            static function (string $value) use ($regex) {
+                return Regex::matches($regex, $value)->success()->getOrElse(false);
+            },
+            \sprintf('does not match "%s"', $regex)
         );
     }
 
     /**
      * Assert that the callback returns true for each variable.
      *
-     * @param callable $callback
-     * @param string   $message
+     * @param callable(?string):bool $callback
+     * @param string                 $message
      *
-     * @throws \Dotenv\Exception\InvalidCallbackException|\Dotenv\Exception\ValidationException
+     * @throws \Dotenv\Exception\ValidationException
      *
      * @return \Dotenv\Validator
      */
-    protected function assertCallback($callback, $message = 'failed callback assertion')
+    public function assert(callable $callback, string $message)
     {
-        if (!is_callable($callback)) {
-            throw new InvalidCallbackException('The provided callback must be callable.');
-        }
+        $failing = [];
 
-        $variablesFailingAssertion = array();
-        foreach ($this->variables as $variableName) {
-            $variableValue = $this->loader->getEnvironmentVariable($variableName);
-            if (call_user_func($callback, $variableValue) === false) {
-                $variablesFailingAssertion[] = $variableName." $message";
+        foreach ($this->variables as $variable) {
+            if ($callback($this->repository->get($variable)) === false) {
+                $failing[] = \sprintf('%s %s', $variable, $message);
             }
         }
 
-        if (count($variablesFailingAssertion) > 0) {
-            throw new ValidationException(sprintf(
+        if (\count($failing) > 0) {
+            throw new ValidationException(\sprintf(
                 'One or more environment variables failed assertions: %s.',
-                implode(', ', $variablesFailingAssertion)
+                \implode(', ', $failing)
             ));
         }
 
         return $this;
     }
+
+    /**
+     * Assert that the callback returns true for each variable.
+     *
+     * Skip checking null variable values.
+     *
+     * @param callable(string):bool $callback
+     * @param string                $message
+     *
+     * @throws \Dotenv\Exception\ValidationException
+     *
+     * @return \Dotenv\Validator
+     */
+    public function assertNullable(callable $callback, string $message)
+    {
+        return $this->assert(
+            static function (?string $value) use ($callback) {
+                if ($value === null) {
+                    return true;
+                }
+
+                return $callback($value);
+            },
+            $message
+        );
+    }
 }