[#75] Run a job every X minutes (#82)

* [#75] Run a job every X minutes

* [#75] Fixed cs issue

* [#75] explain the new feature

Author: dhaarbrink

README.md

@@ -129,9 +129,10 @@ If you don't call any of this method, the job will run every minute (* * * * *).
     ```php
     $scheduler->php('script.php')->at('* * * * *');
     ```
-- `everyMinute` - Run every minute
+- `everyMinute` - Run every minute. You can optionally pass a `$minute` to specify the job runs every `$minute` minutes.
     ```php
     $scheduler->php('script.php')->everyMinute();
+    $scheduler->php('script.php')->everyMinute(5);
     ```
 - `hourly` - Run once per hour. You can optionally pass the `$minute` you want to run, by default it will run every hour at minute '00'.
     ```php

src/GO/Traits/Interval.php

@@ -39,11 +39,19 @@ public function date($date)
     /**
      * Set the execution time to every minute.
      *
+     * @param int|string|null When set, specifies that the job will be run every $minute minutes
+     *
      * @return self
      */
-    public function everyMinute()
+    public function everyMinute($minute = null)
     {
-        return $this->at('* * * * *');
+        $minuteExpression = '*';
+        if ($minute !== null) {
+            $c = $this->validateCronSequence($minute);
+            $minuteExpression = '*/' . $c['minute'];
+        }
+
+        return $this->at($minuteExpression . ' * * * *');
     }
 
     /**

tests/GO/IntervalTest.php

@@ -264,4 +264,14 @@ public function testShouldFailIfDifferentYear()
         // As instance of datetime
         $this->assertFalse($job->date('2018-01-01')->isDue(new \DateTime('2019-01-01')));
     }
+
+    public function testEveryMinuteWithParameter()
+    {
+        $job = new Job('ls');
+
+        // Job should run at 10:00, 10:05, 10:10 etc., but not at 10:02
+        $this->assertTrue($job->everyMinute(5)->isDue(\DateTime::createFromFormat('H:i', '10:00')));
+        $this->assertFalse($job->everyMinute(5)->isDue(\DateTime::createFromFormat('H:i', '10:02')));
+        $this->assertTrue($job->everyMinute(5)->isDue(\DateTime::createFromFormat('H:i', '10:05')));
+    }
 }