README update and added timeout option

Author: marickvantuil

README.md

@@ -25,6 +25,7 @@ This is a package that stores and queues e-mails using a database table. Easily
   - [Resend failed e-mails](#resend-failed-e-mails)
   - [Encryption (optional)](#encryption-optional)
   - [Test mode (optional)](#test-mode-optional)
+  - [E-mails to send per minute](#e-mails-to-send-per-minute)
 
 ### Installation
 
@@ -63,10 +64,12 @@ Now add the e-mail cronjob to your scheduler.
  */
 protected function schedule(Schedule $schedule)
 {
-     $schedule->command('email:send')->everyMinute()->withoutOverlapping(5);
+     $schedule->command('email:send', ['--timeout' => 300])->everyMinute()->withoutOverlapping(5);
 }
 ```
 
+Using the above configuration, the `email:send` process will exit after 5 minutes (`--timeout`) and won't overlap if the process still runs after 5 minutes (`withoutOverlapping`)
+
 ### Usage
 
 #### Send an email
@@ -195,4 +198,8 @@ With encryption the table size is ± 50.58 MB.
 
 #### Test mode (Optional)
 
-When enabled, all newly created e-mails will be sent to the specified test e-mail address. This is turned off by default.
+When enabled, all newly created e-mails will be sent to the specified test e-mail address. This is turned off by default.
+
+#### E-mails to send per minute
+
+To configure how many e-mails should be sent each command, please check the `limit` option. The default is `20` e-mails every command.

src/SendEmailsCommand.php

@@ -13,7 +13,7 @@ class SendEmailsCommand extends Command
      *
      * @var string
      */
-    protected $signature = 'email:send';
+    protected $signature = 'email:send {--timeout=300}';
 
     /**
      * The console command description.
@@ -48,6 +48,8 @@ public function __construct(Store $store)
      */
     public function handle()
     {
+        set_time_limit($this->option('timeout'));
+
         $emails = $this->store->getQueue();
 
         if ($emails->isEmpty()) {
@@ -70,6 +72,8 @@ public function handle()
         $progress->finish();
 
         $this->result($emails);
+
+        set_time_limit(0);
     }
 
     /**

tests/SendEmailsCommandTest.php

@@ -123,4 +123,18 @@ function the_failed_status_and_error_is_cleared_if_a_previously_failed_email_is_
         $this->assertFalse($email->fresh()->hasFailed());
         $this->assertEmpty($email->fresh()->getError());
     }
+
+    /** @test */
+    function the_command_will_be_stopped_after_the_timeout()
+    {
+        $this->assertEquals(0, ini_get('max_execution_time'));
+
+        $this->artisan('email:send');
+
+        $this->assertEquals(300, ini_get('max_execution_time'));
+
+        $this->artisan('email:send', ['--timeout' => 60]);
+
+        $this->assertEquals(60, ini_get('max_execution_time'));
+    }
 }