Added DateTimeBefore, DateTimeAfter, DateTimeBetween, Equals & FileEx…

…ists

README.md

@@ -41,6 +41,11 @@ The following validation rules are currently available:
 | Decimal             | validation.decimal              | Requires that the given value is a decimal with an appropriate format - see class for details |
 | EncodedImage        | validation.encoded_image        | Requires that the given value is a base64-encoded image of a given mime type - see class for details |
 | LocationCoordinates | validation.location_coordinates | Requires that the given value is a comma-separated set of latitude and longitude coordinates |
+| DateTimeBefore      | validation.datetime_before      | Requires that the given value is before a given date - see class for details |
+| DateTimeAfter       | validation.datetime_after       | Requires that the given value is after a given date - see class for details |
+| DateTimeBetween     | validation.datetime_between     | Requires that the given value is between two dates - see class for details |
+| FileExists          | validation.file_exists          | Requires that the given value is a path to an existing file - see class for details |
+| Equals              | validation.equals               | Requires that the given value is equal to another given value |
 
 The package will receive new rules over time, however since these updates will not be breaking changes, they will not receive major version numbers unless Laravel changes in such a way that the package requires a re-write.
 

src/DateTimeAfter.php

@@ -0,0 +1,92 @@
+<?php
+
+// Namespace
+namespace Alphametric\Validation\Rules;
+
+// Using directives
+use Carbon\Carbon;
+
+// Date time after rule
+class DateTimeAfter extends Rule
+{
+
+    /**
+     * The date format for the rule.
+     *
+     **/
+    protected $date_format;
+
+
+
+    /**
+     * The minimum acceptable date.
+     *
+     **/
+    protected $minimum;
+
+
+
+    /**
+     * The time zone for the rule.
+     *
+     **/
+    protected $time_zone;
+
+
+
+    /**
+     * Constructor.
+     *
+     * @param none.
+     * @return instance.
+     *
+     **/
+    public function __construct()
+    {
+		$this->minimum     = func_get_args()[0];
+		$this->date_format = func_get_args()[1] ?? 'Y-m-d H:i:s';
+		$this->time_zone   = func_get_args()[2] ?? 'UTC';
+    }
+
+
+
+    /**
+     * Determine if the validation rule passes.
+     *
+     * The rule has three parameters:
+     * 1. The minimum date / time permitted.
+     * 2. The PHP date format, defaults to 'Y-m-d H:i:s'.
+     * 3. The PHP time zone, defaults to 'UTC'.
+     *
+     * @param string $attribute.
+     * @param mixed $value.
+     * @return bool.
+     *
+     **/
+    public function passes($attribute, $value)
+    {
+        $boundary = Carbon::createFromFormat($this->date_format, $this->minimum, $this->time_zone);
+
+        return Carbon::createFromFormat($this->date_format, $value, $this->time_zone)->greaterThan($boundary);
+    }
+
+
+
+    /**
+     * Get the validation error message.
+     *
+     * @param none.
+     * @return string.
+     *
+     **/
+    public function message()
+    {
+        return Helper::getLocalizedErrorMessage(
+            'datetime_after',
+            'The :attribute must be a date / time after ' .
+            Carbon::createFromFormat($this->date_format, $this->minimum, $this->time_zone)
+                  ->format('jS F Y @ g:i:s A')
+        );
+    }
+
+}

src/DateTimeBefore.php

@@ -0,0 +1,92 @@
+<?php
+
+// Namespace
+namespace Alphametric\Validation\Rules;
+
+// Using directives
+use Carbon\Carbon;
+
+// Date time before rule
+class DateTimeBefore extends Rule
+{
+
+    /**
+     * The date format for the rule.
+     *
+     **/
+    protected $date_format;
+
+
+
+    /**
+     * The maximum acceptable date.
+     *
+     **/
+    protected $maximum;
+
+
+
+    /**
+     * The time zone for the rule.
+     *
+     **/
+    protected $time_zone;
+
+
+
+    /**
+     * Constructor.
+     *
+     * @param none.
+     * @return instance.
+     *
+     **/
+    public function __construct()
+    {
+		$this->maximum     = func_get_args()[0];
+		$this->date_format = func_get_args()[1] ?? 'Y-m-d H:i:s';
+		$this->time_zone   = func_get_args()[2] ?? 'UTC';
+    }
+
+
+
+    /**
+     * Determine if the validation rule passes.
+     *
+     * The rule has three parameters:
+     * 1. The maximum date / time permitted.
+     * 2. The PHP date format, defaults to 'Y-m-d H:i:s'.
+     * 3. The PHP time zone, defaults to 'UTC'.
+     *
+     * @param string $attribute.
+     * @param mixed $value.
+     * @return bool.
+     *
+     **/
+    public function passes($attribute, $value)
+    {
+        $boundary = Carbon::createFromFormat($this->date_format, $this->maximum, $this->time_zone);
+
+        return Carbon::createFromFormat($this->date_format, $value, $this->time_zone)->lessThan($boundary);
+    }
+
+
+
+    /**
+     * Get the validation error message.
+     *
+     * @param none.
+     * @return string.
+     *
+     **/
+    public function message()
+    {
+        return Helper::getLocalizedErrorMessage(
+            'datetime_before',
+            'The :attribute must be a date / time before ' .
+            Carbon::createFromFormat($this->date_format, $this->maximum, $this->time_zone)
+                  ->format('jS F Y @ g:i:s A')
+        );
+    }
+
+}

src/DateTimeBetween.php

@@ -0,0 +1,108 @@
+<?php
+
+// Namespace
+namespace Alphametric\Validation\Rules;
+
+// Using directives
+use Carbon\Carbon;
+
+// Date time between rule
+class DateTimeBetween extends Rule
+{
+
+    /**
+     * The date format for the rule.
+     *
+     **/
+    protected $date_format;
+
+
+
+    /**
+     * The maximum acceptable date.
+     *
+     **/
+    protected $maximum;
+
+
+
+    /**
+     * The minimum acceptable date.
+     *
+     **/
+    protected $minimum;
+
+
+
+    /**
+     * The time zone for the rule.
+     *
+     **/
+    protected $time_zone;
+
+
+
+    /**
+     * Constructor.
+     *
+     * @param none.
+     * @return instance.
+     *
+     **/
+    public function __construct()
+    {
+		$this->minimum     = func_get_args()[0];
+		$this->maximum     = func_get_args()[1];
+		$this->date_format = func_get_args()[2] ?? 'Y-m-d H:i:s';
+		$this->time_zone   = func_get_args()[3] ?? 'UTC';
+    }
+
+
+
+    /**
+     * Determine if the validation rule passes.
+     *
+     * The rule has four parameters:
+     * 1. The minimum date / time permitted.
+     * 2. The maximum date / time permitted.
+     * 3. The PHP date format, defaults to 'Y-m-d H:i:s'.
+     * 4. The PHP time zone, defaults to 'UTC'.
+     *
+     * @param string $attribute.
+     * @param mixed $value.
+     * @return bool.
+     *
+     **/
+    public function passes($attribute, $value)
+    {
+        $boundary_start = Carbon::createFromFormat($this->date_format, $this->minimum, $this->time_zone);
+        $boundary_finish = Carbon::createFromFormat($this->date_format, $this->maximum, $this->time_zone);
+
+		$date_time = Carbon::createFromFormat($this->date_format, $value, $this->time_zone);
+
+        return $date_time->greaterThan($boundary_start) && $date_time->lessThan($boundary_finish);
+    }
+
+
+
+    /**
+     * Get the validation error message.
+     *
+     * @param none.
+     * @return string.
+     *
+     **/
+    public function message()
+    {
+        return Helper::getLocalizedErrorMessage(
+            'datetime_between',
+            'The :attribute must be a date / time after ' .
+            Carbon::createFromFormat($this->date_format, $this->minimum, $this->time_zone)
+                  ->format('jS F Y @ g:i:s A') .
+			' and before ' .
+			Carbon::createFromFormat($this->date_format, $this->maximum, $this->time_zone)
+                  ->format('jS F Y @ g:i:s A')
+        );
+    }
+
+}

src/Decimal.php

@@ -25,9 +25,9 @@ public function example()
     /**
      * Determine if the validation rule passes.
      *
-     * The decimal requires two parameters:
-     * 2. The maximum number of digits before the decimal point.
-     * 3. The maximum number of digits after the decimal point.
+     * The rule has two parameters:
+     * 1. The maximum number of digits before the decimal point.
+     * 2. The maximum number of digits after the decimal point.
      *
      * @param string $attribute.
      * @param mixed $value.

src/Equals.php

@@ -0,0 +1,44 @@
+<?php
+
+// Namespace
+namespace Alphametric\Validation\Rules;
+
+// Equals rule
+class Equals extends Rule
+{
+
+    /**
+     * Determine if the validation rule passes.
+     *
+     * This rule is semantic sugar. You can achieve the
+	 * same result by using the native 'in' rule, but
+	 * using 'equals' may make the intention clearer.
+     *
+     * @param string $attribute.
+     * @param mixed $value.
+     * @return bool.
+     *
+     **/
+    public function passes($attribute, $value)
+    {
+        return $this->parameters[0] === $value;
+    }
+
+
+
+    /**
+     * Get the validation error message.
+     *
+     * @param none.
+     * @return string.
+     *
+     **/
+    public function message()
+    {
+        return Helper::getLocalizedErrorMessage(
+            'equals',
+            'The :attribute must be set to "' . $this->parameters[0] . '"'
+        );
+    }
+
+}