Add request limiter properly, including options.

Author: noplanman

CHANGELOG.md

@@ -5,6 +5,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 ### Added
 - PHP CodeSniffer introduced and cleaned code to pass tests.
 - Custom exceptions for better error handling.
+- Request limiter options.
 
 ## [0.42.0.1] - 2017-04-11
 ### Added

README.md

@@ -167,8 +167,8 @@ Here is a list of available extra parameters:
 | *array*              | *e.g.* `['message', 'edited_channel_post', 'callback_query']` |
 | logging              | Path(s) where to the log files should be put. This is an array that can contain all 3 log file paths (`error`, `debug` and `update`). |
 | *array*              | *e.g.* `['error' => __DIR__ . '/php-telegram-bot-error.log']` |
-| limiter              | Enable or disable the limiter functionality |
-| *bool*               | *e.g.* `true` or `false` |
+| limiter              | Enable or disable the limiter functionality, also accepts options array. |
+| *bool|array*         | *e.g.* `true` or `false` or `['interval' => 2]` |
 | admins               | An array of user ids that have admin access to your bot. |
 | *array*              | *e.g.* `[12345]` |
 | mysql                | Mysql credentials to connect a database (necessary for [`getUpdates`](#using-getupdates-method) method!). |

src/BotManager.php

@@ -270,7 +270,7 @@ public function setBotExtras(): self
         }
 
         $request_extras = [
-            'limiter' => 'setLimiter',
+            // None at the moment...
         ];
         // For request extras, just pass the single param value to the Request method.
         foreach ($request_extras as $param_key => $method) {
@@ -280,6 +280,14 @@ public function setBotExtras(): self
             }
         }
 
+        // Special cases.
+        $limiter = $this->params->getBotParam('limiter', []);
+        if (is_array($limiter)) {
+            Request::setLimiter(true, $limiter);
+        } else {
+            Request::setLimiter($limiter);
+        }
+
         $command_configs = $this->params->getBotParam('command_configs');
         if (is_array($command_configs)) {
             /** @var array $command_configs */

src/Params.php

@@ -78,6 +78,7 @@ class Params
      * max_connections (int) Maximum allowed simultaneous HTTPS connections to the webhook
      * allowed_updates (array) List the types of updates you want your bot to receive
      * logging (array) Array of logger files to set.
+     * limiter (bool|array) Set limiter, as bool or options array.
      * admins (array) List of admins to enable.
      * mysql (array) MySQL credentials to use.
      * download_path (string) Custom download path to set.