Touch up code and changelog, fix docblocks.

Author: noplanman

CHANGELOG.md

@@ -7,7 +7,7 @@ Exclamation symbols (:exclamation:) note something of importance e.g. breaking c
 ### Notes
 - [:ledger: View file changes][Unreleased]
 ### Added
-- New method `setUpdateFilter($callback)` used to filter `processUpdate(Update $update)` calls. If `$callback` evaluates to false the update is not processed and a `ServerResponse()` is returned where `->isOk()` is false.
+- New method `setUpdateFilter($callback)` used to filter `processUpdate(Update $update)` calls. If `$callback` returns `false` the update isn't processed and an empty falsey `ServerResponse` is returned. (@VRciF)
 - Replaced 'generic' and 'genericmessage' strings with Telegram::GENERIC_COMMAND and Telegram::GENERIC_MESSAGE_COMMAND constants (@1int)
 - Bot API 4.8 (Extra Poll and Dice features).
 - Allow custom MySQL port to be defined for tests.

src/Telegram.php

@@ -144,7 +144,7 @@ class Telegram
      *
      * @var integer
      */
-    protected $last_update_id = null;
+    protected $last_update_id;
 
     /**
      * The command to be executed when there's a new message update and nothing more suitable is found
@@ -162,7 +162,7 @@ class Telegram
      *
      * @var callback
      */
-    protected $update_filter = null;
+    protected $update_filter;
 
     /**
      * Telegram constructor.
@@ -463,18 +463,17 @@ public function processUpdate(Update $update)
         $this->update         = $update;
         $this->last_update_id = $update->getUpdateId();
 
-        $allowed = true;
         if (is_callable($this->update_filter)) {
             try {
-                $allowed = (bool)call_user_func_array($this->update_filter, [$update, $this]);
+                $allowed = (bool) call_user_func($this->update_filter, $update, $this);
             } catch (\Exception $e) {
                 $allowed = false;
             }
-        }
 
-        if (!$allowed) {
-            TelegramLog::debug('Update denied by update_filter');
-            return new ServerResponse(['ok' => false, 'description' => 'denied'], null);
+            if (!$allowed) {
+                TelegramLog::debug('Update denied by update_filter');
+                return new ServerResponse(['ok' => false, 'description' => 'denied'], null);
+            }
         }
 
         //Load admin commands
@@ -1016,18 +1015,21 @@ public function getLastUpdateId()
     /**
      * Set an update filter callback
      *
+     * @param callable $callback
+     *
      * @return Telegram
      */
     public function setUpdateFilter(callable $callback)
     {
         $this->update_filter = $callback;
+
         return $this;
     }
 
     /**
      * Return update filter callback
      *
-     * @return callable or null
+     * @return callable|null
      */
     public function getUpdateFilter()
     {