Merge branch 'develop' into 772-simple_prevent_system_command_calls

.editorconfig

@@ -7,3 +7,6 @@ charset = utf-8
 indent_style = space
 indent_size = 4
 trim_trailing_whitespace = true
+
+[*.{yml, yaml}]
+indent_size = 2

.gitattributes

+/.* export-ignore
+/composer.lock export-ignore
+/phpcs.xml.dist export-ignore
+/phpunit.xml.dist export-ignore
+/tests export-ignore

.github/FUNDING.yml

+tidelift: packagist/longman%2Ftelegram-bot
+patreon: phptelegrambot
+liberapay: PHP-Telegram-Bot
+open_collective: php-telegram-bot
+ko_fi: phptelegrambot
+custom: https://github.com/php-telegram-bot/core#donate

.github/ISSUE_TEMPLATE.md

-<!-- If this is a feature request or idea, please remove all the text below this line before writing. -->
-
-<!-- If this is a bug report or support request, please fill in the info below as accurately as you can. -->
-
-### Required Information
-<!-- Please enter exact version numbers, not just "latest" etc.! -->
-- Operating system:
-- PHP version:
-- PHP Telegram Bot version:
-- Using MySQL database: yes / no
-- MySQL version:
-- Update Method: Webhook / getUpdates
-- Self-signed certificate: yes / no
-- RAW update (if available):
-
-### Expected behaviour
-<!-- What SHOULD be happening? -->
-
-### Actual behaviour
-<!-- What IS happening? -->
-
-### Steps to reproduce
-<!-- Explain how to reproduce the issue -->
-
-### Extra details
-<!-- Please post any extra details that might help solve the issue (e.g. logs) -->

.github/ISSUE_TEMPLATE/BC_Break.md

+---
+name: 💥 BC Break
+about: Have you encountered an issue during an upgrade? 💣
+---
+
+<!--
+Before reporting a BC break, please consult the changelog and wiki entry for the particular version to make sure it's not an expected change:
+- https://github.com/php-telegram-bot/core/blob/master/CHANGELOG.md
+- https://github.com/php-telegram-bot/core/wiki/Breaking-backwards-compatibility
+-->
+
+### BC Break Report
+
+<--
+❗ NEVER put your Telegram API key or any other private details here. (like passwords, user IDs, etc.)
+Substitute them like <API_KEY> or <USER_ID> etc.
+-->
+
+#### Required Information
+
+<!-- Fill in the relevant information below to help triage your pull request. -->
+<!-- Please enter exact version numbers, not just "latest" etc.! -->
+
+|  ?                        |  !
+| ---                       | ---
+| Operating system          | Name and version
+| PHP Telegram Bot version  | x.y.z
+| PHP version               | x.y.z
+| MySQL version             | x.y.z / none
+| Update Method             | Webhook / getUpdates
+| Self-signed certificate   | yes / no
+| RAW update (if available) | `{...}`
+
+#### Summary
+
+<!-- Provide a summary describing the problem you are experiencing. -->
+
+#### Previous behaviour
+
+<!-- What was the previous (working) behaviour? -->
+
+#### Current behaviour
+
+<!-- What is the current (broken) behaviour? -->
+
+#### How to reproduce
+
+<!--
+Provide steps to reproduce the bug.
+If possible, also add any relevant code snippet.
+-->
+
+#### Expected behaviour
+
+<!-- What was the expected (correct) behaviour? -->

.github/ISSUE_TEMPLATE/Bug.md

+---
+name: 🐞 Bug Report
+about: Something is broken? 🔨
+---
+
+### Bug Report
+
+<--
+❗ NEVER put your Telegram API key or any other private details here. (like passwords, user IDs, etc.)
+Substitute them like <API_KEY> or <USER_ID> etc.
+-->
+
+#### Required Information
+
+<!-- Fill in the relevant information below to help triage your pull request. -->
+<!-- Please enter exact version numbers, not just "latest" etc.! -->
+
+|  ?                        |  !
+| ---                       | ---
+| Operating system          | Name and version
+| PHP Telegram Bot version  | x.y.z
+| PHP version               | x.y.z
+| MySQL version             | x.y.z / none
+| Update Method             | Webhook / getUpdates
+| Self-signed certificate   | yes / no
+| RAW update (if available) | `{...}`
+
+#### Summary
+
+<!-- Provide a summary describing the problem you are experiencing. -->
+
+### Current behaviour
+
+<!-- What is the current (buggy) behaviour? -->
+
+#### How to reproduce
+
+<!--
+Provide steps to reproduce the bug.
+If possible, also add any relevant code snippet.
+-->
+
+#### Expected behaviour
+
+<!-- What was the expected (correct) behaviour? -->

.github/ISSUE_TEMPLATE/Feature_Request.md

+---
+name: 🎉 Feature Request
+about: You have a neat idea that should be implemented? 🎩
+---
+
+### Feature Request
+
+#### Summary
+
+<!-- Provide a summary of the feature you would like to see implemented. -->

.github/ISSUE_TEMPLATE/Support_Question.md

+---
+name: ❓ Support Question
+about: Have a problem that you can't figure out? 🤔
+---
+
+### Support Question
+
+<!--
+Before asking a question here, please try asking in the support group first.
+https://telegram.me/PHP_Telegram_Bot_Support
+
+Keep in mind that GitHub is primarily an issue tracker.
+-->
+
+<--
+❗ NEVER put your Telegram API key or any other private details here. (like passwords, user IDs, etc.)
+Substitute them like <API_KEY> or <USER_ID> etc.
+-->
+
+#### Required Information
+
+<!-- Fill in the relevant information below to help triage your pull request. -->
+<!-- Please enter exact version numbers, not just "latest" etc.! -->
+
+|  ?                        |  !
+| ---                       | ---
+| Operating system          | Name and version
+| PHP Telegram Bot version  | x.y.z
+| PHP version               | x.y.z
+| MySQL version             | x.y.z / none
+| Update Method             | Webhook / getUpdates
+| Self-signed certificate   | yes / no
+| RAW update (if available) | `{...}`
+
+#### Summary
+
+<!-- Describe the issue you are facing here. -->

.github/PULL_REQUEST_TEMPLATE.md

-<!-- Important: If this pull request is not related to any issue and contains a new feature, please create an issue first for discussion. -->
+<!--
+Important:
+If this pull request is not related to any issue and contains a new feature, please create an issue first for discussion.
+https://github.com/php-telegram-bot/core/issues/new?template=Feature_Request.md
 
-<!-- Make sure this pull request is pointed towards the "develop" branch and refers to any issue that it's related to! -->
+Make sure this pull request is pointed towards the "develop" branch and refers to any issue that it's related to!
+-->
 
-<!-- Explain in detail what this pull request contains. -->
+<!-- Fill in the relevant information below to help triage your pull request. -->
+
+| ?            |  !
+|---           | ---
+| Type         | bug / feature / improvement
+| BC Break     | yes / no
+| Fixed issues | <!-- use #NUM format to reference an issue -->
+
+#### Summary
+
+<!-- Provide a summary of your change. -->

.gitignore

@@ -5,28 +5,20 @@
 .DS_Store
 .idea
 .phpintel
-composer.phar
-
-# Local System Files (i.e. cache, logs, etc.) #
-/cache
-/build/logs
-/build/coverage
-/tmp
-
-# Test Related Files #
-/phpunit.xml
-
-#Exception output
-TelegramException.log
 
 # Composer
-vendor/
+/composer.phar
+/vendor
 
+# Test-Related Files
+/clover.xml
+/phpcs.xml
+/phpunit.xml
 
-# phpDocumentor Logs #
+# phpDocumentor Logs
 phpdoc-*
 
-# OSX #
+# OSX
 ._*
 .Spotlight-V100
 .Trashes

.scrutinizer.yml

+build:
+  nodes:
+    analysis:
+      tests:
+        override:
+          - php-scrutinizer-run
+
 filter:
-    paths: [src/*]
+  paths:
+    - src/
+  dependency_paths:
+    - lib/
 
 checks:
-    php:
-        remove_extra_empty_lines: true
-        remove_php_closing_tag: true
-        remove_trailing_whitespace: true
-        fix_use_statements:
-            remove_unused: true
-            preserve_multiple: false
-            preserve_blanklines: true
-            order_alphabetically: true
-        fix_php_opening_tag: true
-        fix_linefeed: true
-        fix_line_ending: true
-        fix_identation_4spaces: true
-        fix_doc_comments: true
+  php:
+    check_method_contracts:
+      verify_interface_like_constraints: true
+      verify_documented_constraints: true
+      verify_parent_constraints: true
+    fix_doc_comments: true
+    fix_identation_4spaces: true
+    fix_line_ending: true
+    fix_linefeed: true
+    fix_php_opening_tag: true
+    fix_use_statements:
+      remove_unused: true
+      preserve_multiple: false
+      preserve_blanklines: true
+      order_alphabetically: true
+    more_specific_types_in_doc_comments: true
+    no_goto: true
+    param_doc_comment_if_not_inferrable: true
+    parameter_doc_comments: true
+    remove_extra_empty_lines: true
+    return_doc_comment_if_not_inferrable: true
+    return_doc_comments: true
+    simplify_boolean_return: true
 
 tools:
-    external_code_coverage:
-        timeout: 120
+  external_code_coverage:
+    timeout: 300

.travis.yml

-dist: trusty
-sudo: required
 language: php
+sudo: required
+dist: trusty
 
 addons:
   mariadb: 10.1
 
 cache:
   directories:
-    - "$HOME/.composer/cache"
+    - vendor
+    - $HOME/.composer/cache
 
 php:
-  - 5.5
-  - 5.6
-  - 7.0
-  - 7.1
-  - 7.2
   - 7.3
+  - 7.2
+  - 7.1
+  - 7.0
+  - 5.6
+  - 5.5
   - nightly
   - hhvm
 
@@ -44,7 +45,7 @@ before_script:
 
 script:
   - composer check-code
-  - if [ "$TRAVIS_PHP_VERSION" == "7.2" ] ; then composer test-cov; else composer test; fi
+  - if [ "$TRAVIS_PHP_VERSION" == "7.3" ]; then composer test-cov; else composer test; fi
 
 after_script:
-  - if [ "$TRAVIS_PHP_VERSION" == "7.2" ]; then composer test-cov-upload; fi
+  - if [ "$TRAVIS_PHP_VERSION" == "7.3" ]; then composer test-cov-upload; fi

CHANGELOG.md

@@ -5,15 +5,23 @@ Exclamation symbols (:exclamation:) note something of importance e.g. breaking c
 
 ## [Unreleased]
 ### Added
+- New funding and support details.
+- Custom issue templates. (#972)
 ### Changed
 - Use PSR-12 for code style.
+- Some general housekeeping. (#972)
+- [:exclamation:][unreleased-bc] Return an empty array for Entity properties with no items, instead of `null`. (#969)
+- `TelegramLog` now adheres to [PSR-3] `LoggerInterface` and allows custom logger implementations.
 ### Deprecated
+- Old logging that uses Monolog still works but will be removed in the near future. Use `TelegramLog::initialize($logger, $update_logger);` from now on.
 - [:exclamation:][unreleased-bc-startcommand-is-now-a-usercommand] `StartCommand` is now a `UserCommand` (not `SystemCommand` any more).
 ### Removed
 - Botan.io integration completely removed.
 ### Fixed
 - `forward_date` is now correctly saved to the DB.
+- Broken `StickerSet::getStickers()` method.
 ### Security
+- Security disclosure managed by Tidelift.
 - Don't allow a user to call system commands directly.
 
 ## [0.57.0] - 2019-06-01
@@ -267,7 +275,11 @@ Exclamation symbols (:exclamation:) note something of importance e.g. breaking c
 - Move `hideKeyboard` to `removeKeyboard`.
 
 [unreleased-sql-migration]: https://github.com/php-telegram-bot/core/tree/develop/utils/db-schema-update/unreleased.sql
+<<<<<<< HEAD
 [unreleased-bc-startcommand-is-now-a-usercommand]: https://github.com/php-telegram-bot/core/wiki/Breaking-backwards-compatibility#startcommand-is-now-a-usercommand
+=======
+[unreleased-bc]: https://github.com/php-telegram-bot/core/wiki/Breaking-backwards-compatibility#unreleased
+>>>>>>> upstream/develop
 [0.57.0-sql-migration]: https://github.com/php-telegram-bot/core/tree/master/utils/db-schema-update/0.56.0-0.57.0.sql
 [0.55.0-sql-migration]: https://github.com/php-telegram-bot/core/tree/master/utils/db-schema-update/0.54.1-0.55.0.sql
 [0.55.0-bc-move-animation-out-of-games-namespace]: https://github.com/php-telegram-bot/core/wiki/Breaking-backwards-compatibility#move-animation-out-of-games-namespace
@@ -286,6 +298,7 @@ Exclamation symbols (:exclamation:) note something of importance e.g. breaking c
 [0.45.0-bc-up-download-directory]: https://github.com/php-telegram-bot/core/wiki/Breaking-backwards-compatibility#up-download-directory
 [0.44.0-bc-update-content-type]: https://github.com/php-telegram-bot/core/wiki/Breaking-backwards-compatibility#update-getupdatecontent
 [example-bot]: https://github.com/php-telegram-bot/example-bot
+[PSR-3]: https://www.php-fig.org/psr/psr-3
 
 [Unreleased]: https://github.com/php-telegram-bot/core/compare/master...develop
 [0.57.0]: https://github.com/php-telegram-bot/core/compare/0.56.0...0.57.0

.github/CONTRIBUTING.md → CONTRIBUTING.md

-Contributing
--------------
+# Contributing
 
 The easiest way to contribute is to work on a checkout of your own fork.
 When working on the `core` repository, it makes sense to rename your fork to `php-telegram-bot`.
 
-Before you contribute code, please make sure it conforms to the PSR-2 coding standard and that the unit tests still pass.
+Before you contribute code, please make sure it conforms to the PSR-12 coding standard and that the unit tests still pass.
 You can run the following commands to check if everything is ready to submit:
 
-    cd php-telegram-bot
-    composer install
-    composer check-code
+```bash
+cd php-telegram-bot
+composer install
+composer check-code
+```
 
 Which should give you no output, indicating that there are no coding standard errors.
 And then (remember to set up your test database!):
 
-    composer test
+```bash
+composer test
+```
 
 Which should give you no failures or errors. You can ignore any skipped tests as these are for external tools.
 
-Pushing
--------
+## Pushing
 
 Development is based on the git flow branching model (see http://nvie.com/posts/a-successful-git-branching-model/)
 If you fix a bug please push in hotfix branch.
 If you develop a new feature please create a new branch.
 
-Version
--------
+## Version
 
 Version number: 0.#version.#hotfix
 
-Further code convention adopted
--------------------------------
+## Further code convention adopted
 
 - Each method and class is documented with a docblock
 

README.md

+<img src="assets/logo/512px/logo_plain.png" title="PHP Telegram Bot" alt="PHP Telegram Bot logo">
+
 # PHP Telegram Bot
 
+A Telegram Bot based on the official [Telegram Bot API][Telegram-Bot-API]
+
 [![Join the bot support group on Telegram](https://img.shields.io/badge/telegram-@PHP__Telegram__Bot__Support-32a2da.svg)](https://telegram.me/PHP_Telegram_Bot_Support)
 [![Donate](https://img.shields.io/badge/%F0%9F%92%99-Donate-blue.svg)](#donate)
 
 [![Build Status](https://travis-ci.org/php-telegram-bot/core.svg?branch=master)](https://travis-ci.org/php-telegram-bot/core)
-[![Code Coverage](https://img.shields.io/scrutinizer/coverage/g/php-telegram-bot/core/develop.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-telegram-bot/core/?b=develop)
-[![Code Quality](https://img.shields.io/scrutinizer/g/php-telegram-bot/core/develop.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-telegram-bot/core/?b=develop)
-[![Latest Stable Version](https://img.shields.io/packagist/v/Longman/telegram-bot.svg)](https://packagist.org/packages/longman/telegram-bot)
-[![Total Downloads](https://img.shields.io/packagist/dt/Longman/telegram-bot.svg)](https://packagist.org/packages/longman/telegram-bot)
-[![Downloads Month](https://img.shields.io/packagist/dm/Longman/telegram-bot.svg)](https://packagist.org/packages/longman/telegram-bot)
+[![Dependencies](https://tidelift.com/badges/github/php-telegram-bot/core)][Tidelift]
+[![Code Coverage](https://img.shields.io/scrutinizer/coverage/g/php-telegram-bot/core/master.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-telegram-bot/core/?b=master)
+[![Code Quality](https://img.shields.io/scrutinizer/g/php-telegram-bot/core/master.svg?style=flat-square)](https://scrutinizer-ci.com/g/php-telegram-bot/core/?b=master)
+[![Latest Stable Version](https://img.shields.io/packagist/v/longman/telegram-bot.svg)](https://packagist.org/packages/longman/telegram-bot)
+[![Total Downloads](https://img.shields.io/packagist/dt/longman/telegram-bot.svg)](https://packagist.org/packages/longman/telegram-bot)
+[![Downloads Month](https://img.shields.io/packagist/dm/longman/telegram-bot.svg)](https://packagist.org/packages/longman/telegram-bot)
 [![Minimum PHP Version](http://img.shields.io/badge/php-%3E%3D5.6-8892BF.svg)](https://php.net/)
-[![License](https://img.shields.io/packagist/l/Longman/telegram-bot.svg)](https://github.com/php-telegram-bot/core/LICENSE.md)
+[![License](https://img.shields.io/packagist/l/longman/telegram-bot.svg)](https://github.com/php-telegram-bot/core/LICENSE)
 
 ![Telegram Bot API Logo](assets/logo/512px/logo_plain.png)
 
@@ -22,10 +27,11 @@ A Telegram Bot based on the official [Telegram Bot API][Telegram-Bot-API]
     - [Create your first bot](#create-your-first-bot)
     - [Require this package with Composer](#require-this-package-with-composer)
     - [Choose how to retrieve Telegram updates](#choose-how-to-retrieve-telegram-updates)
-    - [Webhook installation](#webhook-installation)
+- [Webhook installation](#webhook-installation)
     - [Self Signed Certificate](#self-signed-certificate)
     - [Unset Webhook](#unset-webhook)
-    - [getUpdates installation](#getupdates-installation)
+- [getUpdates installation](#getupdates-installation)
+    - [getUpdates without database](#getupdates-without-database)
 - [Support](#support)
     - [Types](#types)
     - [Inline Query](#inline-query)
@@ -38,14 +44,15 @@ A Telegram Bot based on the official [Telegram Bot API][Telegram-Bot-API]
     - [Send message to all active chats](#send-message-to-all-active-chats)
 - [Utils](#utils)
     - [MySQL storage (Recommended)](#mysql-storage-recommended)
+        - [External Database connection](#external-database-connection)
     - [Channels Support](#channels-support)
 - [Commands](#commands)
     - [Predefined Commands](#predefined-commands)
     - [Custom Commands](#custom-commands)
     - [Commands Configuration](#commands-configuration)
-- [Admin Commands](#admin-commands)
-    - [Set Admins](#set-admins)
-    - [Channel Administration](#channel-administration)
+    - [Admin Commands](#admin-commands)
+        - [Set Admins](#set-admins)
+        - [Channel Administration](#channel-administration)
 - [Upload and Download directory path](#upload-and-download-directory-path)
 - [Logging](doc/01-utils.md)
 - [Documentation](#documentation)
@@ -53,6 +60,7 @@ A Telegram Bot based on the official [Telegram Bot API][Telegram-Bot-API]
 - [Projects with this library](#projects-with-this-library)
 - [Troubleshooting](#troubleshooting)
 - [Contributing](#contributing)
+- [Security](#security)
 - [Donate](#donate)
 - [License](#license)
 - [Credits](#credits)
@@ -178,7 +186,7 @@ composer require longman/telegram-bot
 
 ### Choose how to retrieve Telegram updates
 
-The bot can handle updates with **Webhook** or **getUpdates** method:
+The bot can handle updates with [**Webhook**](#webhook-installation) or [**getUpdates**](#getupdates-installation) method:
 
 |      | Webhook | getUpdates |
 | ---- | :----: | :----: |
@@ -186,7 +194,6 @@ The bot can handle updates with **Webhook** or **getUpdates** method:
 | Host with https | Required | Not required |
 | MySQL | Not required | ([Not](#getupdates-without-database)) Required  |
 
-
 ## Webhook installation
 
 Note: For a more detailed explanation, head over to the [example-bot repository][example-bot-repository] and follow the instructions there.
@@ -442,9 +449,9 @@ $telegram->enableExternalMySql($external_pdo_connection)
 All methods implemented can be used to manage channels.
 With [admin commands](#admin-commands) you can manage your channels directly with your bot private chat.
 
-### Commands
+## Commands
 
-#### Predefined Commands
+### Predefined Commands
 
 The bot is able to recognise commands in a chat with multiple bots (/command@mybot).
 
@@ -470,14 +477,14 @@ Here's the list:
     - Favourite colour? */black, /red*
     - Favourite number? */1, /134*
 
-#### Custom Commands
+### Custom Commands
 
 Maybe you would like to develop your own commands.
 There is a guide to help you [create your own commands][wiki-create-your-own-commands].
 
 Also, be sure to have a look at the [example commands][ExampleCommands-folder] to learn more about custom commands and how they work.
 
-#### Commands Configuration
+### Commands Configuration
 
 With this method you can set some command specific parameters, for example:
 
@@ -546,7 +553,7 @@ $telegram->setCommandConfig('sendtochannel', [
 ```
 - Enjoy!
 
-### Upload and Download directory path
+## Upload and Download directory path
 
 To use the Upload and Download functionality, you need to set the paths with:
 ```php
@@ -578,7 +585,15 @@ If you like living on the edge, please report any bugs you find on the
 
 ## Contributing
 
-See [CONTRIBUTING](.github/CONTRIBUTING.md) for more information.
+See [CONTRIBUTING](CONTRIBUTING.md) for more information.
+
+## Security
+
+See [SECURITY](SECURITY.md) for more information.
+
+## Security
+
+See [SECURITY](SECURITY.md) for more information.
 
 ## Donate
 
@@ -587,15 +602,20 @@ If you enjoy using this library and would like to say thank you, donations are a
 
 Donations are invested back into the project :+1:
 
-- Gratipay: [Gratipay/PHP-Telegram-Bot]
-- Liberapay: [Liberapay/PHP-Telegram-Bot]
-- PayPal: [PayPal/noplanman] (account of @noplanman)
-- Bitcoin: [166NcyE7nDxkRPWidWtG1rqrNJoD5oYNiV][bitcoin]
-- Ethereum: [0x485855634fa212b0745375e593fAaf8321A81055][ethereum]
+Thank you for keeping this project alive :pray:
+
+- [![Patreon](https://user-images.githubusercontent.com/9423417/59235980-a5fa6b80-8be3-11e9-8ae7-020bc4ae9baa.png) Patreon.com/phptelegrambot][Patreon]
+- [![OpenCollective](https://user-images.githubusercontent.com/9423417/59235978-a561d500-8be3-11e9-89be-82ec54be1546.png) OpenCollective.com/php-telegram-bot][OpenCollective]
+- [![Ko-fi](https://user-images.githubusercontent.com/9423417/59235976-a561d500-8be3-11e9-911d-b1908c3e6a33.png) Ko-fi.com/phptelegrambot][Ko-fi]
+- [![Tidelift](https://user-images.githubusercontent.com/9423417/59235982-a6930200-8be3-11e9-8ac2-bfb6991d80c5.png) Tidelift.com/longman/telegram-bot][Tidelift]
+- [![Liberapay](https://user-images.githubusercontent.com/9423417/59235977-a561d500-8be3-11e9-9d16-bc3b13d3ceba.png) Liberapay.com/PHP-Telegram-Bot][Liberapay]
+- [![PayPal](https://user-images.githubusercontent.com/9423417/59235981-a5fa6b80-8be3-11e9-9761-15eb7a524cb0.png) PayPal.me/noplanman][PayPal-noplanman] (account of @noplanman)
+- [![Bitcoin](https://user-images.githubusercontent.com/9423417/59235974-a4c93e80-8be3-11e9-9fde-260c821b6eae.png) 166NcyE7nDxkRPWidWtG1rqrNJoD5oYNiV][Bitcoin]
+- [![Ethereum](https://user-images.githubusercontent.com/9423417/59235975-a4c93e80-8be3-11e9-8762-7a47c62c968d.png) 0x485855634fa212b0745375e593fAaf8321A81055][Ethereum]
 
 ## License
 
-Please see the [LICENSE](LICENSE.md) included in this repository for a full copy of the MIT license,
+Please see the [LICENSE](LICENSE) included in this repository for a full copy of the MIT license,
 which this project is licensed under.
 
 ## Credits
@@ -620,8 +640,12 @@ Credit list in [CREDITS](CREDITS)
 [wiki]: https://github.com/php-telegram-bot/core/wiki "PHP Telegram Bot Wiki"
 [wiki-create-your-own-commands]: https://github.com/php-telegram-bot/core/wiki/Create-your-own-commands "Create your own commands"
 [issues]: https://github.com/php-telegram-bot/core/issues "PHP Telegram Bot Issues"
-[Gratipay/PHP-Telegram-Bot]: https://gratipay.com/PHP-Telegram-Bot "Donate with Gratipay"
-[Liberapay/PHP-Telegram-Bot]: https://liberapay.com/PHP-Telegram-Bot "Donate with Liberapay"
-[PayPal/noplanman]: https://paypal.me/noplanman "Donate with PayPal"
-[bitcoin]: bitcoin:166NcyE7nDxkRPWidWtG1rqrNJoD5oYNiV "Donate with Bitcoin"
-[ethereum]: https://www.myetherwallet.com/?to=0x485855634fa212b0745375e593fAaf8321A81055 "Donate with Ethereum"
+
+[Patreon]: https://www.patreon.com/phptelegrambot "Support us on Patreon"
+[OpenCollective]: https://opencollective.com/php-telegram-bot "Support us on Open Collective"
+[Ko-fi]: https://ko-fi.com/phptelegrambot "Support us on Ko-fi"
+[Tidelift]: https://tidelift.com/subscription/pkg/packagist-longman-telegram-bot?utm_source=packagist-longman-telegram-bot&utm_medium=referral&utm_campaign=readme "Support us on Tidelift"
+[Liberapay]: https://liberapay.com/PHP-Telegram-Bot "Donate with Liberapay"
+[PayPal-noplanman]: https://paypal.me/noplanman "Donate with PayPal"
+[Bitcoin]: https://www.blockchain.com/btc/address/166NcyE7nDxkRPWidWtG1rqrNJoD5oYNiV "Donate with Bitcoin"
+[Ethereum]: https://etherscan.io/address/0x485855634fa212b0745375e593fAaf8321A81055 "Donate with Ethereum"

SECURITY.md

+# Security
+
+To report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security).
+Tidelift will then coordinate the fix and disclosure.

composer.json

@@ -28,6 +28,7 @@
         "ext-curl": "*",
         "ext-json": "*",
         "ext-mbstring": "*",
+        "psr/log": "^1.1",
         "monolog/monolog": "^1.24",
         "guzzlehttp/guzzle": "^6.3"
     },
@@ -47,16 +48,16 @@
     },
     "scripts": {
         "check-code": [
-            "\"vendor/bin/phpcs\" --standard=phpcs.xml -snp src/ tests/"
+            "\"vendor/bin/phpcs\" -snp src/ tests/"
         ],
         "test": [
             "\"vendor/bin/phpunit\""
         ],
         "test-cov": [
-            "\"vendor/bin/phpunit\" --coverage-clover build/logs/clover.xml"
+            "\"vendor/bin/phpunit\" --coverage-clover clover.xml"
         ],
         "test-cov-upload": [
-            "wget https://scrutinizer-ci.com/ocular.phar && php ocular.phar code-coverage:upload --format=php-clover build/logs/clover.xml"
+            "wget https://scrutinizer-ci.com/ocular.phar && php ocular.phar code-coverage:upload --format=php-clover clover.xml"
         ]
     }
 }

composer.lock

@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "b3ac8abe31dc69491d76f5b4bb65ca26",
+    "content-hash": "07b4a4919442371656638370b1b75f85",
     "packages": [
         {
             "name": "guzzlehttp/guzzle",

doc/01-utils.md

 ## Logging
-PHP Telegram Bot library features [Monolog](https://github.com/Seldaek/monolog) to store logs.
+PHP Telegram Bot library features [PSR-3] compatible logging to store logs.
+
+You can find a list of compatible packages that can be used on [Packagist][PSR-3-providers].
 
 Logs are divided into the following streams:
-### Error
-Collects all the exceptions thrown by the library:
-```php
-TelegramLog::initErrorLog($path . '/' . $BOT_NAME . '_error.log');
-```
+- `error`: Collects all the exceptions thrown by the library.
+- `debug`: Stores requests made to the Telegram API, useful for debugging.
+- `update`: Incoming raw updates (JSON string from Webhook and getUpdates).
+
+### Initialisation
+To initialise the logger, you can pass any `LoggerInterface` objects to the `TelegramLog::initialize` method.
+
+The first parameter is the main logger, the second one is used for the raw updates.
 
-### Debug
-Stores requests made to the Telegram API, useful for debugging:
+(in this example we're using [Monolog])
 ```php
-TelegramLog::initDebugLog($path . '/' . $BOT_NAME . '_debug.log');
+use Monolog\Formatter\LineFormatter;
+use Monolog\Handler\StreamHandler;
+use Monolog\Logger;
+use Longman\TelegramBot\TelegramLog;
+
+TelegramLog::initialize(
+    // Main logger that handles all 'error' and 'debug' logs.
+    new Logger('telegram_bot', [
+        (new StreamHandler(__DIR__ . "/logs/{$bot_username}_debug.log", Logger::DEBUG))->setFormatter(new LineFormatter(null, null, true)),
+        (new StreamHandler(__DIR__ . "/logs/{$bot_username}_error.log", Logger::ERROR))->setFormatter(new LineFormatter(null, null, true)),
+    ]),
+    // Updates logger for raw updates.
+    new Logger('telegram_bot_updates', [
+        (new StreamHandler(__DIR__ . "/logs/{$bot_username}_update.log", Logger::INFO))->setFormatter(new LineFormatter('%message%' . PHP_EOL)),
+    ])
+);
 ```
 
 ### Raw data
-Incoming updates (JSON string from Webhook and getUpdates) get logged in a text file:
-```php
-TelegramLog::initUpdateLog($path . '/' . $BOT_NAME . '_update.log');
-```
 Why do I need to log the raw updates?
 Telegram API changes continuously and it often happens that the database schema is not up to date with new entities/features. So it can happen that your table schema doesn't allow storing new valuable information coming from Telegram.
 
 If you store the raw data you can import all updates on the newest table schema by simply using [this script](../utils/importFromLog.php).
 Remember to always backup first!!
 
-## Stream and external sources
-Error and Debug streams rely on the `bot_log` instance that can be provided from an external source:
-```php
-TelegramLog::initialize($monolog);
-```
 
-Raw data relies on the `bot_update_log` instance that uses a custom format.
+[PSR-3]: https://www.php-fig.org/psr/psr-3
+[PSR-3-providers]: https://packagist.org/providers/psr/log-implementation
+[Monolog]: https://github.com/Seldaek/monolog

phpunit.xml.dist

 <?xml version="1.0" encoding="UTF-8"?>
 <phpunit
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:noNamespaceSchemaLocation="http://schema.phpunit.de/4.8/phpunit.xsd"
-        bootstrap="./tests/bootstrap.php"
-        backupGlobals="false"
-        backupStaticAttributes="false"
-        colors="true"
-        convertErrorsToExceptions="true"
-        convertNoticesToExceptions="true"
-        convertWarningsToExceptions="true"
-        processIsolation="false"
-        stopOnError="false"
-        stopOnFailure="false"
-        stopOnIncomplete="false"
-        stopOnSkipped="false"
-        syntaxCheck="true"
-        timeoutForLargeTests="60"
-        timeoutForMediumTests="10"
-        timeoutForSmallTests="1"
-        verbose="false"
-        >
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:noNamespaceSchemaLocation="http://schema.phpunit.de/4.8/phpunit.xsd"
+    bootstrap="./tests/bootstrap.php"
+    backupGlobals="false"
+    backupStaticAttributes="false"
+    colors="true"
+    convertErrorsToExceptions="true"
+    convertNoticesToExceptions="true"
+    convertWarningsToExceptions="true"
+    processIsolation="false"
+    stopOnError="false"
+    stopOnFailure="false"
+    stopOnIncomplete="false"
+    stopOnSkipped="false"
+    syntaxCheck="true"
+    timeoutForLargeTests="60"
+    timeoutForMediumTests="10"
+    timeoutForSmallTests="1"
+    verbose="false"
+>
     <php>
-        <ini name="error_reporting" value="-1" />
+        <ini name="error_reporting" value="-1"/>
         <const name="PHPUNIT_TESTSUITE" value="true"/>
         <const name="PHPUNIT_DB_HOST" value="127.0.0.1"/>
         <const name="PHPUNIT_DB_NAME" value="telegrambot"/>

src/Commands/AdminCommands/ChatsCommand.php

@@ -13,6 +13,8 @@ namespace Longman\TelegramBot\Commands\AdminCommands;
 use Longman\TelegramBot\Commands\AdminCommand;
 use Longman\TelegramBot\DB;
 use Longman\TelegramBot\Entities\Chat;
+use Longman\TelegramBot\Entities\ServerResponse;
+use Longman\TelegramBot\Exception\TelegramException;
 use Longman\TelegramBot\Request;
 
 class ChatsCommand extends AdminCommand
@@ -45,8 +47,8 @@ class ChatsCommand extends AdminCommand
     /**
      * Command execute method
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function execute()
     {

src/Commands/AdminCommands/CleanupCommand.php

@@ -12,6 +12,7 @@ namespace Longman\TelegramBot\Commands\AdminCommands;
 
 use Longman\TelegramBot\Commands\AdminCommand;
 use Longman\TelegramBot\DB;
+use Longman\TelegramBot\Entities\ServerResponse;
 use Longman\TelegramBot\Exception\TelegramException;
 use Longman\TelegramBot\Request;
 use Longman\TelegramBot\TelegramLog;
@@ -338,7 +339,8 @@ class CleanupCommand extends AdminCommand
     /**
      * Execution if MySQL is required but not available
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function executeNoDb()
     {
@@ -357,8 +359,8 @@ class CleanupCommand extends AdminCommand
     /**
      * Command execute method
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function execute()
     {

src/Commands/AdminCommands/DebugCommand.php

@@ -12,6 +12,7 @@ namespace Longman\TelegramBot\Commands\AdminCommands;
 
 use Longman\TelegramBot\Commands\AdminCommand;
 use Longman\TelegramBot\DB;
+use Longman\TelegramBot\Exception\TelegramException;
 use Longman\TelegramBot\Request;
 
 /**
@@ -43,14 +44,14 @@ class DebugCommand extends AdminCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     public function execute()
     {
-        $pdo = DB::getPdo();
+        $pdo     = DB::getPdo();
         $message = $this->getMessage();
-        $chat = $message->getChat();
-        $text = strtolower($message->getText(true));
+        $chat    = $message->getChat();
+        $text    = strtolower($message->getText(true));
 
         $data = ['chat_id' => $chat->getId()];
 
@@ -80,7 +81,7 @@ class DebugCommand extends AdminCommand
         $debug_info[] = sprintf('*Maximum PHP script execution time:* `%d seconds`', ini_get('max_execution_time'));
 
         $mysql_version = $pdo ? $pdo->query('SELECT VERSION() AS version')->fetchColumn() : null;
-        $debug_info[] = sprintf('*MySQL version:* `%s`', $mysql_version ?: 'disabled');
+        $debug_info[]  = sprintf('*MySQL version:* `%s`', $mysql_version ?: 'disabled');
 
         $debug_info[] = sprintf('*Operating System:* `%s`', php_uname());
 
@@ -88,7 +89,7 @@ class DebugCommand extends AdminCommand
             $debug_info[] = sprintf('*Web Server:* `%s`', $_SERVER['SERVER_SOFTWARE']);
         }
         if (function_exists('curl_init')) {
-            $curlversion = curl_version();
+            $curlversion  = curl_version();
             $debug_info[] = sprintf('*curl version:* `%1$s; %2$s`', $curlversion['version'], $curlversion['ssl_version']);
         }
 
@@ -105,8 +106,8 @@ class DebugCommand extends AdminCommand
                 }
 
                 $webhook_info_result_str = json_encode($webhook_info_result, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
-                $debug_info[] = $webhook_info_title;
-                $debug_info[] = sprintf(
+                $debug_info[]            = $webhook_info_title;
+                $debug_info[]            = sprintf(
                     '```' . PHP_EOL . '%s```',
                     $webhook_info_result_str
                 );
@@ -116,7 +117,7 @@ class DebugCommand extends AdminCommand
         }
 
         $data['parse_mode'] = 'Markdown';
-        $data['text'] = implode(PHP_EOL, $debug_info);
+        $data['text']       = implode(PHP_EOL, $debug_info);
 
         return Request::sendMessage($data);
     }

src/Commands/AdminCommands/SendtoallCommand.php

@@ -13,6 +13,7 @@ namespace Longman\TelegramBot\Commands\AdminCommands;
 use Longman\TelegramBot\Commands\AdminCommand;
 use Longman\TelegramBot\Entities\Message;
 use Longman\TelegramBot\Entities\ServerResponse;
+use Longman\TelegramBot\Exception\TelegramException;
 use Longman\TelegramBot\Request;
 
 /**
@@ -48,8 +49,8 @@ class SendtoallCommand extends AdminCommand
     /**
      * Execute command
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function execute()
     {

src/Commands/AdminCommands/SendtochannelCommand.php

@@ -15,6 +15,8 @@ use Longman\TelegramBot\Conversation;
 use Longman\TelegramBot\Entities\Chat;
 use Longman\TelegramBot\Entities\Keyboard;
 use Longman\TelegramBot\Entities\Message;
+use Longman\TelegramBot\Entities\ServerResponse;
+use Longman\TelegramBot\Exception\TelegramException;
 use Longman\TelegramBot\Request;
 
 class SendtochannelCommand extends AdminCommand
@@ -47,15 +49,15 @@ class SendtochannelCommand extends AdminCommand
     /**
      * Conversation Object
      *
-     * @var \Longman\TelegramBot\Conversation
+     * @var Conversation
      */
     protected $conversation;
 
     /**
      * Command execute method
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse|mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse|mixed
+     * @throws TelegramException
      */
     public function execute()
     {
@@ -272,11 +274,11 @@ class SendtochannelCommand extends AdminCommand
      * @todo This method will be moved to a higher level maybe in AdminCommand or Command
      * @todo Looking for a more significant name
      *
-     * @param \Longman\TelegramBot\Entities\Message $message
-     * @param array                                 $data
+     * @param Message $message
+     * @param array   $data
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     protected function sendBack(Message $message, array $data)
     {
@@ -311,12 +313,12 @@ class SendtochannelCommand extends AdminCommand
     /**
      * Publish a message to a channel and return success or failure message in markdown format
      *
-     * @param \Longman\TelegramBot\Entities\Message $message
-     * @param string|int                            $channel_id
-     * @param string|null                           $caption
+     * @param Message     $message
+     * @param string|int  $channel_id
+     * @param string|null $caption
      *
      * @return string
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     protected function publish(Message $message, $channel_id, $caption = null)
     {
@@ -351,7 +353,7 @@ class SendtochannelCommand extends AdminCommand
      * @todo Why send just to the first found channel?
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     public function executeNoDb()
     {

src/Commands/AdminCommands/WhoisCommand.php

@@ -16,7 +16,9 @@ use Longman\TelegramBot\Commands\AdminCommand;
 use Longman\TelegramBot\DB;
 use Longman\TelegramBot\Entities\Chat;
 use Longman\TelegramBot\Entities\PhotoSize;
+use Longman\TelegramBot\Entities\ServerResponse;
 use Longman\TelegramBot\Entities\UserProfilePhotos;
+use Longman\TelegramBot\Exception\TelegramException;
 use Longman\TelegramBot\Request;
 
 /**
@@ -52,8 +54,8 @@ class WhoisCommand extends AdminCommand
     /**
      * Command execute method
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function execute()
     {

src/Commands/Command.php

@@ -18,7 +18,9 @@ use Longman\TelegramBot\Entities\Message;
 use Longman\TelegramBot\Entities\Payments\PreCheckoutQuery;
 use Longman\TelegramBot\Entities\Payments\ShippingQuery;
 use Longman\TelegramBot\Entities\Poll;
+use Longman\TelegramBot\Entities\ServerResponse;
 use Longman\TelegramBot\Entities\Update;
+use Longman\TelegramBot\Exception\TelegramException;
 use Longman\TelegramBot\Request;
 use Longman\TelegramBot\Telegram;
 
@@ -43,14 +45,14 @@ abstract class Command
     /**
      * Telegram object
      *
-     * @var \Longman\TelegramBot\Telegram
+     * @var Telegram
      */
     protected $telegram;
 
     /**
      * Update object
      *
-     * @var \Longman\TelegramBot\Entities\Update
+     * @var Update
      */
     protected $update;
 
@@ -120,8 +122,8 @@ abstract class Command
     /**
      * Constructor
      *
-     * @param \Longman\TelegramBot\Telegram        $telegram
-     * @param \Longman\TelegramBot\Entities\Update $update
+     * @param Telegram $telegram
+     * @param Update   $update
      */
     public function __construct(Telegram $telegram, Update $update = null)
     {
@@ -133,9 +135,9 @@ abstract class Command
     /**
      * Set update object
      *
-     * @param \Longman\TelegramBot\Entities\Update $update
+     * @param Update $update
      *
-     * @return \Longman\TelegramBot\Commands\Command
+     * @return Command
      */
     public function setUpdate(Update $update = null)
     {
@@ -149,8 +151,8 @@ abstract class Command
     /**
      * Pre-execute command
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function preExecute()
     {
@@ -182,16 +184,16 @@ abstract class Command
     /**
      * Execute command
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     abstract public function execute();
 
     /**
      * Execution if MySQL is required but not available
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function executeNoDb()
     {
@@ -210,7 +212,7 @@ abstract class Command
     /**
      * Get update object
      *
-     * @return \Longman\TelegramBot\Entities\Update
+     * @return Update
      */
     public function getUpdate()
     {
@@ -260,7 +262,7 @@ abstract class Command
     /**
      * Get telegram object
      *
-     * @return \Longman\TelegramBot\Telegram
+     * @return Telegram
      */
     public function getTelegram()
     {
@@ -399,7 +401,8 @@ abstract class Command
      * @param string $text
      * @param array  $data
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function replyToChat($text, array $data = [])
     {
@@ -419,7 +422,8 @@ abstract class Command
      * @param string $text
      * @param array  $data
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function replyToUser($text, array $data = [])
     {

src/Commands/SystemCommand.php

@@ -10,6 +10,7 @@
 
 namespace Longman\TelegramBot\Commands;
 
+use Longman\TelegramBot\Entities\ServerResponse;
 use Longman\TelegramBot\Request;
 
 abstract class SystemCommand extends Command
@@ -27,7 +28,7 @@ abstract class SystemCommand extends Command
      * Although system commands should just work and return a successful ServerResponse,
      * each system command can override this method to add custom functionality.
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
+     * @return ServerResponse
      */
     public function execute()
     {

src/Commands/SystemCommands/CallbackqueryCommand.php

@@ -42,7 +42,6 @@ class CallbackqueryCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/ChannelchatcreatedCommand.php

@@ -38,7 +38,6 @@ class ChannelchatcreatedCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/ChannelpostCommand.php

@@ -38,7 +38,6 @@ class ChannelpostCommand extends SystemCommand
      * Execute command
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/ChoseninlineresultCommand.php

@@ -38,7 +38,6 @@ class ChoseninlineresultCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/DeletechatphotoCommand.php

@@ -38,7 +38,6 @@ class DeletechatphotoCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/EditedchannelpostCommand.php

@@ -38,7 +38,6 @@ class EditedchannelpostCommand extends SystemCommand
      * Execute command
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/EditedmessageCommand.php

@@ -38,7 +38,6 @@ class EditedmessageCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/GenericCommand.php

@@ -11,7 +11,7 @@
 namespace Longman\TelegramBot\Commands\SystemCommands;
 
 use Longman\TelegramBot\Commands\SystemCommand;
-use Longman\TelegramBot\Request;
+use Longman\TelegramBot\Entities\ServerResponse;
 
 /**
  * Generic command
@@ -36,8 +36,7 @@ class GenericCommand extends SystemCommand
     /**
      * Command execute method
      *
-     * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
      */
     public function execute()
     {

src/Commands/SystemCommands/GenericmessageCommand.php

@@ -10,9 +10,11 @@
 
 namespace Longman\TelegramBot\Commands\SystemCommands;
 
+use Longman\TelegramBot\Commands\SystemCommand;
 use Longman\TelegramBot\Conversation;
+use Longman\TelegramBot\Entities\ServerResponse;
+use Longman\TelegramBot\Exception\TelegramException;
 use Longman\TelegramBot\Request;
-use Longman\TelegramBot\Commands\SystemCommand;
 
 /**
  * Generic message command
@@ -42,7 +44,7 @@ class GenericmessageCommand extends SystemCommand
     /**
      * Execution if MySQL is required but not available
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
+     * @return ServerResponse
      */
     public function executeNoDb()
     {
@@ -53,8 +55,8 @@ class GenericmessageCommand extends SystemCommand
     /**
      * Execute command
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/GroupchatcreatedCommand.php

@@ -38,7 +38,6 @@ class GroupchatcreatedCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/InlinequeryCommand.php

@@ -11,8 +11,6 @@
 namespace Longman\TelegramBot\Commands\SystemCommands;
 
 use Longman\TelegramBot\Commands\SystemCommand;
-use Longman\TelegramBot\Entities\InlineQuery\InlineQueryResultArticle;
-use Longman\TelegramBot\Entities\InputMessageContent\InputTextMessageContent;
 use Longman\TelegramBot\Request;
 
 /**
@@ -39,7 +37,6 @@ class InlinequeryCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/LeftchatmemberCommand.php

@@ -38,7 +38,6 @@ class LeftchatmemberCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/MigratefromchatidCommand.php

@@ -38,7 +38,6 @@ class MigratefromchatidCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/MigratetochatidCommand.php

@@ -38,7 +38,6 @@ class MigratetochatidCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/NewchatmembersCommand.php

@@ -38,7 +38,6 @@ class NewchatmembersCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/NewchatphotoCommand.php

@@ -38,7 +38,6 @@ class NewchatphotoCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/NewchattitleCommand.php

@@ -38,7 +38,6 @@ class NewchattitleCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/PinnedmessageCommand.php

@@ -38,7 +38,6 @@ class PinnedmessageCommand extends SystemCommand
      * Execute command
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/SystemCommands/SupergroupchatcreatedCommand.php

@@ -38,7 +38,6 @@ class SupergroupchatcreatedCommand extends SystemCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

src/Commands/UserCommands/StartCommand.php

@@ -11,6 +11,8 @@
 namespace Longman\TelegramBot\Commands\UserCommands;
 
 use Longman\TelegramBot\Commands\UserCommand;
+use Longman\TelegramBot\Entities\ServerResponse;
+use Longman\TelegramBot\Exception\TelegramException;
 
 /**
  * Start command
@@ -40,8 +42,8 @@ class StartCommand extends UserCommand
     /**
      * Command execute method
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function execute()
     {

src/Conversation.php

@@ -10,6 +10,8 @@
 
 namespace Longman\TelegramBot;
 
+use Longman\TelegramBot\Exception\TelegramException;
+
 /**
  * Class Conversation
  *
@@ -67,7 +69,7 @@ class Conversation
      * @param int    $chat_id
      * @param string $command
      *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     public function __construct($user_id, $chat_id, $command = null)
     {
@@ -100,7 +102,7 @@ class Conversation
      * Load the conversation from the database
      *
      * @return bool
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     protected function load()
     {
@@ -140,7 +142,7 @@ class Conversation
      * Start a new conversation if the current command doesn't have one yet
      *
      * @return bool
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     protected function start()
     {
@@ -164,6 +166,7 @@ class Conversation
      * Currently the Conversation is not deleted but just set to 'stopped'
      *
      * @return bool
+     * @throws TelegramException
      */
     public function stop()
     {
@@ -174,6 +177,7 @@ class Conversation
      * Cancel the current conversation
      *
      * @return bool
+     * @throws TelegramException
      */
     public function cancel()
     {
@@ -186,6 +190,7 @@ class Conversation
      * @param string $status
      *
      * @return bool
+     * @throws TelegramException
      */
     protected function updateStatus($status)
     {
@@ -209,6 +214,7 @@ class Conversation
      * Store the array/variable in the database with json_encode() function
      *
      * @return bool
+     * @throws TelegramException
      */
     public function update()
     {

src/DB.php

@@ -844,7 +844,7 @@ class DB
 
             $sth->bindValue(':id', $poll->getId());
             $sth->bindValue(':question', $poll->getQuestion());
-            $sth->bindValue(':options', self::entitiesArrayToJson($poll->getOptions()));
+            $sth->bindValue(':options', self::entitiesArrayToJson($poll->getOptions() ?: null));
             $sth->bindValue(':is_closed', $poll->getIsClosed());
             $sth->bindValue(':created_at', self::getTimestamp());
 
@@ -976,13 +976,13 @@ class DB
             $sth->bindValue(':media_group_id', $message->getMediaGroupId());
             $sth->bindValue(':author_signature', $message->getAuthorSignature());
             $sth->bindValue(':text', $message->getText());
-            $sth->bindValue(':entities', self::entitiesArrayToJson($message->getEntities()));
-            $sth->bindValue(':caption_entities', self::entitiesArrayToJson($message->getCaptionEntities()));
+            $sth->bindValue(':entities', self::entitiesArrayToJson($message->getEntities() ?: null));
+            $sth->bindValue(':caption_entities', self::entitiesArrayToJson($message->getCaptionEntities() ?: null));
             $sth->bindValue(':audio', $message->getAudio());
             $sth->bindValue(':document', $message->getDocument());
             $sth->bindValue(':animation', $message->getAnimation());
             $sth->bindValue(':game', $message->getGame());
-            $sth->bindValue(':photo', self::entitiesArrayToJson($message->getPhoto()));
+            $sth->bindValue(':photo', self::entitiesArrayToJson($message->getPhoto() ?: null));
             $sth->bindValue(':sticker', $message->getSticker());
             $sth->bindValue(':video', $message->getVideo());
             $sth->bindValue(':voice', $message->getVoice());
@@ -995,7 +995,7 @@ class DB
             $sth->bindValue(':new_chat_members', $new_chat_members_ids);
             $sth->bindValue(':left_chat_member', $left_chat_member_id);
             $sth->bindValue(':new_chat_title', $message->getNewChatTitle());
-            $sth->bindValue(':new_chat_photo', self::entitiesArrayToJson($message->getNewChatPhoto()));
+            $sth->bindValue(':new_chat_photo', self::entitiesArrayToJson($message->getNewChatPhoto() ?: null));
             $sth->bindValue(':delete_chat_photo', $message->getDeleteChatPhoto());
             $sth->bindValue(':group_chat_created', $message->getGroupChatCreated());
             $sth->bindValue(':supergroup_chat_created', $message->getSupergroupChatCreated());
@@ -1058,7 +1058,7 @@ class DB
             $sth->bindValue(':user_id', $user_id);
             $sth->bindValue(':edit_date', $edit_date);
             $sth->bindValue(':text', $edited_message->getText());
-            $sth->bindValue(':entities', self::entitiesArrayToJson($edited_message->getEntities()));
+            $sth->bindValue(':entities', self::entitiesArrayToJson($edited_message->getEntities() ?: null));
             $sth->bindValue(':caption', $edited_message->getCaption());
 
             return $sth->execute();
@@ -1186,13 +1186,13 @@ class DB
      * @param integer $chat_id
      * @param string  $inline_message_id
      *
-     * @return array|bool Array containing TOTAL and CURRENT fields or false on invalid arguments
+     * @return array Array containing TOTAL and CURRENT fields or false on invalid arguments
      * @throws TelegramException
      */
     public static function getTelegramRequestCount($chat_id = null, $inline_message_id = null)
     {
         if (!self::isDbConnected()) {
-            return false;
+            return [];
         }
 
         try {

src/Entities/CallbackQuery.php

@@ -30,7 +30,7 @@ class CallbackQuery extends Entity
     /**
      * {@inheritdoc}
      */
-    public function subEntities()
+    protected function subEntities()
     {
         return [
             'from'    => User::class,

src/Entities/Chat.php

@@ -46,7 +46,7 @@ class Chat extends Entity
     /**
      * {@inheritdoc}
      */
-    public function subEntities()
+    protected function subEntities()
     {
         return [
             'photo'          => ChatPhoto::class,

src/Entities/ChatMember.php

@@ -38,7 +38,7 @@ class ChatMember extends Entity
     /**
      * {@inheritdoc}
      */
-    public function subEntities()
+    protected function subEntities()
     {
         return [
             'user' => User::class,

src/Entities/Entity.php

@@ -33,8 +33,6 @@ abstract class Entity
      *
      * @param array  $data
      * @param string $bot_username
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct($data, $bot_username = '')
     {
@@ -96,8 +94,6 @@ abstract class Entity
 
     /**
      * Perform any special entity validation
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     protected function validate()
     {
@@ -142,7 +138,13 @@ abstract class Entity
                 $sub_entities = $this->subEntities();
 
                 if (isset($sub_entities[$property_name])) {
-                    return new $sub_entities[$property_name]($property, $this->getProperty('bot_username'));
+                    $class = $sub_entities[$property_name];
+
+                    if (is_array($class)) {
+                        return $this->makePrettyObjectArray(reset($class), $property_name);
+                    }
+
+                    return new $class($property, $this->getProperty('bot_username'));
                 }
 
                 return $property;

src/Entities/Games/Game.php

@@ -22,10 +22,12 @@ use Longman\TelegramBot\Entities\PhotoSize;
  *
  * @link https://core.telegram.org/bots/api#game
  *
- * @method string    getTitle()        Title of the game
- * @method string    getDescription()  Description of the game
- * @method string    getText()         Optional. Brief description of the game or high scores included in the game message. Can be automatically edited to include current high scores for the game when the bot calls setGameScore, or manually edited using editMessageText. 0-4096 characters.
- * @method Animation getAnimation()    Optional. Animation that will be displayed in the game message in chats. Upload via BotFather
+ * @method string          getTitle()        Title of the game
+ * @method string          getDescription()  Description of the game
+ * @method PhotoSize[]     getPhoto()        Photo that will be displayed in the game message in chats.
+ * @method string          getText()         Optional. Brief description of the game or high scores included in the game message. Can be automatically edited to include current high scores for the game when the bot calls setGameScore, or manually edited using editMessageText. 0-4096 characters.
+ * @method MessageEntity[] getTextEntities() Optional. Special entities that appear in text, such as usernames, URLs, bot commands, etc.
+ * @method Animation       getAnimation()    Optional. Animation that will be displayed in the game message in chats. Upload via BotFather
  **/
 class Game extends Entity
 {
@@ -35,39 +37,9 @@ class Game extends Entity
     protected function subEntities()
     {
         return [
-            'photo'         => PhotoSize::class,
-            'text_entities' => MessageEntity::class,
+            'photo'         => [PhotoSize::class],
+            'text_entities' => [MessageEntity::class],
             'animation'     => Animation::class,
         ];
     }
-
-    /**
-     * Photo that will be displayed in the game message in chats.
-     *
-     * This method overrides the default getPhoto method
-     * and returns a nice array of PhotoSize objects.
-     *
-     * @return null|\Longman\TelegramBot\Entities\PhotoSize[]
-     */
-    public function getPhoto()
-    {
-        $pretty_array = $this->makePrettyObjectArray(PhotoSize::class, 'photo');
-
-        return empty($pretty_array) ? null : $pretty_array;
-    }
-
-    /**
-     * Optional. Special entities that appear in text, such as usernames, URLs, bot commands, etc.
-     *
-     * This method overrides the default getTextEntities method
-     * and returns a nice array of MessageEntity objects.
-     *
-     * @return null|\Longman\TelegramBot\Entities\MessageEntity[]
-     */
-    public function getTextEntities()
-    {
-        $pretty_array = $this->makePrettyObjectArray(MessageEntity::class, 'text_entities');
-
-        return empty($pretty_array) ? null : $pretty_array;
-    }
 }

src/Entities/InlineQuery/InlineQueryResultArticle.php

@@ -62,8 +62,6 @@ class InlineQueryResultArticle extends InlineEntity implements InlineQueryResult
      * InlineQueryResultArticle constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultAudio.php

@@ -56,8 +56,6 @@ class InlineQueryResultAudio extends InlineEntity implements InlineQueryResult
      * InlineQueryResultAudio constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultCachedAudio.php

@@ -47,8 +47,6 @@ class InlineQueryResultCachedAudio extends InlineEntity implements InlineQueryRe
      * InlineQueryResultCachedAudio constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultCachedDocument.php

@@ -53,8 +53,6 @@ class InlineQueryResultCachedDocument extends InlineEntity implements InlineQuer
      * InlineQueryResultCachedDocument constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultCachedGif.php

@@ -50,8 +50,6 @@ class InlineQueryResultCachedGif extends InlineEntity implements InlineQueryResu
      * InlineQueryResultCachedGif constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultCachedMpeg4Gif.php

@@ -50,8 +50,6 @@ class InlineQueryResultCachedMpeg4Gif extends InlineEntity implements InlineQuer
      * InlineQueryResultCachedMpeg4Gif constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultCachedPhoto.php

@@ -53,8 +53,6 @@ class InlineQueryResultCachedPhoto extends InlineEntity implements InlineQueryRe
      * InlineQueryResultCachedPhoto constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultCachedSticker.php

@@ -44,8 +44,6 @@ class InlineQueryResultCachedSticker extends InlineEntity implements InlineQuery
      * InlineQueryResultCachedSticker constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultCachedVideo.php

@@ -53,8 +53,6 @@ class InlineQueryResultCachedVideo extends InlineEntity implements InlineQueryRe
      * InlineQueryResultCachedVideo constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultCachedVoice.php

@@ -50,8 +50,6 @@ class InlineQueryResultCachedVoice extends InlineEntity implements InlineQueryRe
      * InlineQueryResultCachedVoice constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultContact.php

@@ -61,8 +61,6 @@ class InlineQueryResultContact extends InlineEntity implements InlineQueryResult
      * InlineQueryResultContact constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultDocument.php

@@ -65,8 +65,6 @@ class InlineQueryResultDocument extends InlineEntity implements InlineQueryResul
      * InlineQueryResultDocument constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultGame.php

@@ -40,8 +40,6 @@ class InlineQueryResultGame extends InlineEntity implements InlineQueryResult
      * InlineQueryResultGame constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultGif.php

@@ -61,8 +61,6 @@ class InlineQueryResultGif extends InlineEntity implements InlineQueryResult
      * InlineQueryResultGif constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultLocation.php

@@ -62,8 +62,6 @@ class InlineQueryResultLocation extends InlineEntity implements InlineQueryResul
      * InlineQueryResultLocation constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultMpeg4Gif.php

@@ -61,8 +61,6 @@ class InlineQueryResultMpeg4Gif extends InlineEntity implements InlineQueryResul
      * InlineQueryResultMpeg4Gif constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultPhoto.php

@@ -62,8 +62,6 @@ class InlineQueryResultPhoto extends InlineEntity implements InlineQueryResult
      * InlineQueryResultPhoto constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultVenue.php

@@ -67,8 +67,6 @@ class InlineQueryResultVenue extends InlineEntity implements InlineQueryResult
      * InlineQueryResultVenue constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultVideo.php

@@ -68,8 +68,6 @@ class InlineQueryResultVideo extends InlineEntity implements InlineQueryResult
      * InlineQueryResultVideo constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InlineQuery/InlineQueryResultVoice.php

@@ -53,8 +53,6 @@ class InlineQueryResultVoice extends InlineEntity implements InlineQueryResult
      * InlineQueryResultVoice constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InputMedia/InputMedia.php

@@ -4,5 +4,20 @@ namespace Longman\TelegramBot\Entities\InputMedia;
 
 interface InputMedia
 {
+    /**
+     * @return string Type of the result.
+     */
+    public function getType();
 
+    /**
+     * @return string File to send.
+     */
+    public function getMedia();
+
+    /**
+     * @param string $media File to send.
+     *
+     * @return string
+     */
+    public function setMedia($media);
 }

src/Entities/InputMedia/InputMediaAnimation.php

@@ -52,8 +52,6 @@ class InputMediaAnimation extends Entity implements InputMedia
      * InputMediaAnimation constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InputMedia/InputMediaAudio.php

@@ -52,8 +52,6 @@ class InputMediaAudio extends Entity implements InputMedia
      * InputMediaAudio constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InputMedia/InputMediaDocument.php

@@ -43,8 +43,6 @@ class InputMediaDocument extends Entity implements InputMedia
      * InputMediaDocument constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InputMedia/InputMediaPhoto.php

@@ -40,8 +40,6 @@ class InputMediaPhoto extends Entity implements InputMedia
      * InputMediaPhoto constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/InputMedia/InputMediaVideo.php

@@ -55,8 +55,6 @@ class InputMediaVideo extends Entity implements InputMedia
      * InputMediaVideo constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/Keyboard.php

@@ -54,7 +54,7 @@ class Keyboard extends Entity
     /**
      * Get the proper keyboard button class for this keyboard.
      *
-     * @return KeyboardButton|InlineKeyboardButton
+     * @return string
      */
     public function getKeyboardButtonClass()
     {
@@ -154,9 +154,9 @@ class Keyboard extends Entity
     /**
      * Parse a given button to the correct KeyboardButton object type.
      *
-     * @param array|string|\Longman\TelegramBot\Entities\KeyboardButton $button
+     * @param array|string|KeyboardButton $button
      *
-     * @return \Longman\TelegramBot\Entities\KeyboardButton|null
+     * @return KeyboardButton|null
      */
     protected function parseButton($button)
     {
@@ -166,7 +166,7 @@ class Keyboard extends Entity
             return $button;
         }
 
-        if (!$this->isInlineKeyboard() || $button_class::couldBe($button)) {
+        if (!$this->isInlineKeyboard() || call_user_func([$button_class, 'couldBe'], $button)) {
             return new $button_class($button);
         }
 
@@ -179,7 +179,7 @@ class Keyboard extends Entity
     protected function validate()
     {
         $keyboard_type = $this->getKeyboardType();
-        $keyboard = $this->getProperty($keyboard_type);
+        $keyboard      = $this->getProperty($keyboard_type);
 
         if ($keyboard !== null) {
             if (!is_array($keyboard)) {
@@ -201,8 +201,7 @@ class Keyboard extends Entity
      *
      * @param array $data
      *
-     * @return \Longman\TelegramBot\Entities\Keyboard
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return Keyboard
      */
     public static function remove(array $data = [])
     {
@@ -216,8 +215,7 @@ class Keyboard extends Entity
      *
      * @param array $data
      *
-     * @return \Longman\TelegramBot\Entities\Keyboard
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return Keyboard
      */
     public static function forceReply(array $data = [])
     {

src/Entities/Message.php

@@ -34,10 +34,13 @@ use Longman\TelegramBot\Entities\TelegramPassport\PassportData;
  * @method int               getEditDate()              Optional. Date the message was last edited in Unix time
  * @method string            getMediaGroupId()          Optional. The unique identifier of a media message group this message belongs to
  * @method string            getAuthorSignature()       Optional. Signature of the post author for messages in channels
+ * @method MessageEntity[]   getEntities()              Optional. For text messages, special entities like usernames, URLs, bot commands, etc. that appear in the text
+ * @method MessageEntity[]   getCaptionEntities()       Optional. For messages with a caption, special entities like usernames, URLs, bot commands, etc. that appear in the caption
  * @method Audio             getAudio()                 Optional. Message is an audio file, information about the file
  * @method Document          getDocument()              Optional. Message is a general file, information about the file
  * @method Animation         getAnimation()             Optional. Message is an animation, information about the animation. For backward compatibility, when this field is set, the document field will also be set
  * @method Game              getGame()                  Optional. Message is a game, information about the game.
+ * @method PhotoSize[]       getPhoto()                 Optional. Message is a photo, available sizes of the photo
  * @method Sticker           getSticker()               Optional. Message is a sticker, information about the sticker
  * @method Video             getVideo()                 Optional. Message is a video, information about the video
  * @method Voice             getVoice()                 Optional. Message is a voice message, information about the file
@@ -47,8 +50,10 @@ use Longman\TelegramBot\Entities\TelegramPassport\PassportData;
  * @method Location          getLocation()              Optional. Message is a shared location, information about the location
  * @method Venue             getVenue()                 Optional. Message is a venue, information about the venue
  * @method Poll              getPoll()                  Optional. Message is a native poll, information about the poll
+ * @method User[]            getNewChatMembers()        Optional. A new member(s) was added to the group, information about them (one of this members may be the bot itself)
  * @method User              getLeftChatMember()        Optional. A member was removed from the group, information about them (this member may be the bot itself)
  * @method string            getNewChatTitle()          Optional. A chat title was changed to this value
+ * @method PhotoSize[]       getNewChatPhoto()          Optional. A chat photo was changed to this value
  * @method bool              getDeleteChatPhoto()       Optional. Service message: the chat photo was deleted
  * @method bool              getGroupChatCreated()      Optional. Service message: the group has been created
  * @method bool              getSupergroupChatCreated() Optional. Service message: the supergroup has been created. This field can't be received in a message coming through updates, because bot can’t be a member of a supergroup when it is created. It can only be found in reply_to_message if someone replies to a very first message in a directly created supergroup.
@@ -74,13 +79,13 @@ class Message extends Entity
             'forward_from'       => User::class,
             'forward_from_chat'  => Chat::class,
             'reply_to_message'   => ReplyToMessage::class,
-            'entities'           => MessageEntity::class,
-            'caption_entities'   => MessageEntity::class,
+            'entities'           => [MessageEntity::class],
+            'caption_entities'   => [MessageEntity::class],
             'audio'              => Audio::class,
             'document'           => Document::class,
             'animation'          => Animation::class,
             'game'               => Game::class,
-            'photo'              => PhotoSize::class,
+            'photo'              => [PhotoSize::class],
             'sticker'            => Sticker::class,
             'video'              => Video::class,
             'voice'              => Voice::class,
@@ -89,9 +94,9 @@ class Message extends Entity
             'location'           => Location::class,
             'venue'              => Venue::class,
             'poll'               => Poll::class,
-            'new_chat_members'   => User::class,
+            'new_chat_members'   => [User::class],
             'left_chat_member'   => User::class,
-            'new_chat_photo'     => PhotoSize::class,
+            'new_chat_photo'     => [PhotoSize::class],
             'pinned_message'     => Message::class,
             'invoice'            => Invoice::class,
             'successful_payment' => SuccessfulPayment::class,
@@ -99,94 +104,6 @@ class Message extends Entity
         ];
     }
 
-    /**
-     * Message constructor
-     *
-     * @param array  $data
-     * @param string $bot_username
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
-     */
-    public function __construct(array $data, $bot_username = '')
-    {
-        parent::__construct($data, $bot_username);
-    }
-
-    /**
-     * Optional. Message is a photo, available sizes of the photo
-     *
-     * This method overrides the default getPhoto method
-     * and returns a nice array of PhotoSize objects.
-     *
-     * @return null|PhotoSize[]
-     */
-    public function getPhoto()
-    {
-        $pretty_array = $this->makePrettyObjectArray(PhotoSize::class, 'photo');
-
-        return empty($pretty_array) ? null : $pretty_array;
-    }
-
-    /**
-     * Optional. A chat photo was changed to this value
-     *
-     * This method overrides the default getNewChatPhoto method
-     * and returns a nice array of PhotoSize objects.
-     *
-     * @return null|PhotoSize[]
-     */
-    public function getNewChatPhoto()
-    {
-        $pretty_array = $this->makePrettyObjectArray(PhotoSize::class, 'new_chat_photo');
-
-        return empty($pretty_array) ? null : $pretty_array;
-    }
-
-    /**
-     * Optional. A new member(s) was added to the group, information about them (one of this members may be the bot itself)
-     *
-     * This method overrides the default getNewChatMembers method
-     * and returns a nice array of User objects.
-     *
-     * @return null|User[]
-     */
-    public function getNewChatMembers()
-    {
-        $pretty_array = $this->makePrettyObjectArray(User::class, 'new_chat_members');
-
-        return empty($pretty_array) ? null : $pretty_array;
-    }
-
-    /**
-     * Optional. For text messages, special entities like usernames, URLs, bot commands, etc. that appear in the text
-     *
-     * This method overrides the default getEntities method
-     * and returns a nice array of MessageEntity objects.
-     *
-     * @return null|MessageEntity[]
-     */
-    public function getEntities()
-    {
-        $pretty_array = $this->makePrettyObjectArray(MessageEntity::class, 'entities');
-
-        return empty($pretty_array) ? null : $pretty_array;
-    }
-
-    /**
-     * Optional. For messages with a caption, special entities like usernames, URLs, bot commands, etc. that appear in the caption
-     *
-     * This method overrides the default getCaptionEntities method
-     * and returns a nice array of MessageEntity objects.
-     *
-     * @return null|MessageEntity[]
-     */
-    public function getCaptionEntities()
-    {
-        $pretty_array = $this->makePrettyObjectArray(MessageEntity::class, 'caption_entities');
-
-        return empty($pretty_array) ? null : $pretty_array;
-    }
-
     /**
      * return the entire command like /echo or /echo@bot1 if specified
      *
@@ -264,7 +181,6 @@ class Message extends Entity
      * Bot added in chat
      *
      * @return bool
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function botAddedInChat()
     {

src/Entities/Payments/OrderInfo.php

@@ -29,7 +29,7 @@ class OrderInfo extends Entity
     /**
      * {@inheritdoc}
      */
-    public function subEntities()
+    protected function subEntities()
     {
         return [
             'shipping_address' => ShippingAddress::class,

src/Entities/Payments/PreCheckoutQuery.php

@@ -11,6 +11,7 @@
 namespace Longman\TelegramBot\Entities\Payments;
 
 use Longman\TelegramBot\Entities\Entity;
+use Longman\TelegramBot\Entities\ServerResponse;
 use Longman\TelegramBot\Entities\User;
 use Longman\TelegramBot\Request;
 
@@ -34,7 +35,7 @@ class PreCheckoutQuery extends Entity
     /**
      * {@inheritdoc}
      */
-    public function subEntities()
+    protected function subEntities()
     {
         return [
             'from'       => User::class,
@@ -48,7 +49,7 @@ class PreCheckoutQuery extends Entity
      * @param bool  $ok
      * @param array $data
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
+     * @return ServerResponse
      */
     public function answer($ok, array $data = [])
     {

src/Entities/Payments/ShippingOption.php

@@ -19,8 +19,9 @@ use Longman\TelegramBot\Entities\Entity;
  *
  * @link https://core.telegram.org/bots/api#shippingoption
  *
- * @method string getId()    Shipping option identifier
- * @method string getTitle() Option title
+ * @method string         getId()     Shipping option identifier
+ * @method string         getTitle()  Option title
+ * @method LabeledPrice[] getPrices() List of price portions
  **/
 class ShippingOption extends Entity
 {
@@ -30,19 +31,7 @@ class ShippingOption extends Entity
     protected function subEntities()
     {
         return [
-            'prices' => LabeledPrice::class,
+            'prices' => [LabeledPrice::class],
         ];
     }
-
-    /**
-     * List of price portions
-     *
-     * This method overrides the default getPrices method and returns a nice array
-     *
-     * @return LabeledPrice[]
-     */
-    public function getPrices()
-    {
-        return $this->makePrettyObjectArray(LabeledPrice::class, 'prices');
-    }
 }

src/Entities/Payments/ShippingQuery.php

@@ -11,6 +11,7 @@
 namespace Longman\TelegramBot\Entities\Payments;
 
 use Longman\TelegramBot\Entities\Entity;
+use Longman\TelegramBot\Entities\ServerResponse;
 use Longman\TelegramBot\Entities\User;
 use Longman\TelegramBot\Request;
 
@@ -31,7 +32,7 @@ class ShippingQuery extends Entity
     /**
      * {@inheritdoc}
      */
-    public function subEntities()
+    protected function subEntities()
     {
         return [
             'from'             => User::class,
@@ -45,7 +46,7 @@ class ShippingQuery extends Entity
      * @param bool  $ok
      * @param array $data
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
+     * @return ServerResponse
      */
     public function answer($ok, array $data = [])
     {

src/Entities/Payments/SuccessfulPayment.php

@@ -32,7 +32,7 @@ class SuccessfulPayment extends Entity
     /**
      * {@inheritdoc}
      */
-    public function subEntities()
+    protected function subEntities()
     {
         return [
             'order_info' => OrderInfo::class,

src/Entities/Poll.php

@@ -17,9 +17,10 @@ namespace Longman\TelegramBot\Entities;
  *
  * @link https://core.telegram.org/bots/api#poll
  *
- * @method string getId()       Unique poll identifier
- * @method string getQuestion() Poll question, 1-255 characters
- * @method bool   getIsClosed() True, if the poll is closed
+ * @method string       getId()       Unique poll identifier
+ * @method string       getQuestion() Poll question, 1-255 characters
+ * @method PollOption[] getOptions()  List of poll options
+ * @method bool         getIsClosed() True, if the poll is closed
  */
 class Poll extends Entity
 {
@@ -29,22 +30,7 @@ class Poll extends Entity
     protected function subEntities()
     {
         return [
-            'options' => PollOption::class,
+            'options' => [PollOption::class],
         ];
     }
-
-    /**
-     * List of poll options
-     *
-     * This method overrides the default getOptions method
-     * and returns a nice array of PollOption objects.
-     *
-     * @return null|PollOption[]
-     */
-    public function getOptions()
-    {
-        $pretty_array = $this->makePrettyObjectArray(PollOption::class, 'options');
-
-        return empty($pretty_array) ? null : $pretty_array;
-    }
 }

src/Entities/ReplyToMessage.php

@@ -22,8 +22,6 @@ class ReplyToMessage extends Message
      *
      * @param array  $data
      * @param string $bot_username
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data, $bot_username = '')
     {

src/Entities/ServerResponse.php

@@ -30,8 +30,6 @@ class ServerResponse extends Entity
      *
      * @param array  $data
      * @param string $bot_username
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data, $bot_username)
     {
@@ -105,7 +103,7 @@ class ServerResponse extends Entity
      * @param array  $result
      * @param string $bot_username
      *
-     * @return \Longman\TelegramBot\Entities\Chat|\Longman\TelegramBot\Entities\ChatMember|\Longman\TelegramBot\Entities\File|\Longman\TelegramBot\Entities\Message|\Longman\TelegramBot\Entities\User|\Longman\TelegramBot\Entities\UserProfilePhotos|\Longman\TelegramBot\Entities\WebhookInfo
+     * @return Chat|ChatMember|File|Message|User|UserProfilePhotos|WebhookInfo
      */
     private function createResultObject(array $result, $bot_username)
     {
@@ -135,7 +133,7 @@ class ServerResponse extends Entity
      * @param array  $result
      * @param string $bot_username
      *
-     * @return \Longman\TelegramBot\Entities\ChatMember[]|\Longman\TelegramBot\Entities\Games\GameHighScore[]|\Longman\TelegramBot\Entities\Message[]|\Longman\TelegramBot\Entities\Update[]
+     * @return ChatMember[]|GameHighScore[]|Message[]|Update[]
      */
     private function createResultObjects(array $result, $bot_username)
     {

src/Entities/StickerSet.php

@@ -15,24 +15,20 @@ namespace Longman\TelegramBot\Entities;
  *
  * @link https://core.telegram.org/bots/api#stickerset
  *
- * @method string getName()          Sticker set name
- * @method string getTitle()         Sticker set title
- * @method bool   getContainsMasks() True, if the sticker set contains masks
+ * @method string    getName()          Sticker set name
+ * @method string    getTitle()         Sticker set title
+ * @method bool      getContainsMasks() True, if the sticker set contains masks
+ * @method Sticker[] getStickers()      List of all set stickers
  */
 class StickerSet extends Entity
 {
     /**
-     * List of all set stickers
-     *
-     * This method overrides the default getStickers method
-     * and returns a nice array of Sticker objects.
-     *
-     * @return null|Sticker[]
+     * {@inheritdoc}
      */
-    public function getStickers()
+    protected function subEntities()
     {
-        $pretty_array = $this->makePrettyObjectArray(Sticker::class, 'stickers');
-
-        return empty($pretty_array) ? null : $pretty_array;
+        return [
+            'stickers' => [Sticker::class],
+        ];
     }
 }

src/Entities/TelegramPassport/EncryptedPassportElement.php

@@ -19,14 +19,16 @@ use Longman\TelegramBot\Entities\Entity;
  *
  * @link https://core.telegram.org/bots/api#encryptedpassportelement
  *
- * @method string       getType()        Element type. One of “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport”, “address”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration”, “temporary_registration”, “phone_number”, “email”.
- * @method string       getData()        Optional. Base64-encoded encrypted Telegram Passport element data provided by the user, available for “personal_details”, “passport”, “driver_license”, “identity_card”, “identity_passport” and “address” types. Can be decrypted and verified using the accompanying EncryptedCredentials.
- * @method string       getPhoneNumber() Optional. User's verified phone number, available only for “phone_number” type
- * @method string       getEmail()       Optional. User's verified email address, available only for “email” type
- * @method PassportFile getFrontSide()   Optional. Encrypted file with the front side of the document, provided by the user. Available for “passport”, “driver_license”, “identity_card” and “internal_passport”. The file can be decrypted and verified using the accompanying EncryptedCredentials.
- * @method PassportFile getReverseSide() Optional. Encrypted file with the reverse side of the document, provided by the user. Available for “driver_license” and “identity_card”. The file can be decrypted and verified using the accompanying EncryptedCredentials.
- * @method PassportFile getSelfie()      Optional. Encrypted file with the selfie of the user holding a document, provided by the user; available for “passport”, “driver_license”, “identity_card” and “internal_passport”. The file can be decrypted and verified using the accompanying EncryptedCredentials.
- * @method string       getHash()        Base64-encoded element hash for using in PassportElementErrorUnspecified
+ * @method string         getType()        Element type. One of “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport”, “address”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration”, “temporary_registration”, “phone_number”, “email”.
+ * @method string         getData()        Optional. Base64-encoded encrypted Telegram Passport element data provided by the user, available for “personal_details”, “passport”, “driver_license”, “identity_card”, “identity_passport” and “address” types. Can be decrypted and verified using the accompanying EncryptedCredentials.
+ * @method string         getPhoneNumber() Optional. User's verified phone number, available only for “phone_number” type
+ * @method string         getEmail()       Optional. User's verified email address, available only for “email” type
+ * @method PassportFile[] getFiles()       Optional. Array of encrypted files with documents provided by the user, available for “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration” and “temporary_registration” types. Files can be decrypted and verified using the accompanying EncryptedCredentials.
+ * @method PassportFile   getFrontSide()   Optional. Encrypted file with the front side of the document, provided by the user. Available for “passport”, “driver_license”, “identity_card” and “internal_passport”. The file can be decrypted and verified using the accompanying EncryptedCredentials.
+ * @method PassportFile   getReverseSide() Optional. Encrypted file with the reverse side of the document, provided by the user. Available for “driver_license” and “identity_card”. The file can be decrypted and verified using the accompanying EncryptedCredentials.
+ * @method PassportFile   getSelfie()      Optional. Encrypted file with the selfie of the user holding a document, provided by the user; available for “passport”, “driver_license”, “identity_card” and “internal_passport”. The file can be decrypted and verified using the accompanying EncryptedCredentials.
+ * @method PassportFile[] getTranslation() Optional. Array of encrypted files with translated versions of documents provided by the user. Available if requested for “passport”, “driver_license”, “identity_card”, “internal_passport”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration” and “temporary_registration” types. Files can be decrypted and verified using the accompanying EncryptedCredentials.
+ * @method string         getHash()        Base64-encoded element hash for using in PassportElementErrorUnspecified
  **/
 class EncryptedPassportElement extends Entity
 {
@@ -36,41 +38,11 @@ class EncryptedPassportElement extends Entity
     protected function subEntities()
     {
         return [
-            'files'        => PassportFile::class,
+            'files'        => [PassportFile::class],
             'front_side'   => PassportFile::class,
             'reverse_side' => PassportFile::class,
             'selfie'       => PassportFile::class,
-            'translation'  => PassportFile::class,
+            'translation'  => [PassportFile::class],
         ];
     }
-
-    /**
-     * Optional. Array of encrypted files with documents provided by the user, available for “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration” and “temporary_registration” types. Files can be decrypted and verified using the accompanying EncryptedCredentials.
-     *
-     * This method overrides the default getFiles method
-     * and returns a nice array of PassportFile objects.
-     *
-     * @return null|PassportFile[]
-     */
-    public function getFiles()
-    {
-        $pretty_array = $this->makePrettyObjectArray(PassportFile::class, 'files');
-
-        return empty($pretty_array) ? null : $pretty_array;
-    }
-
-    /**
-     * Optional. Array of encrypted files with translated versions of documents provided by the user. Available if requested for “passport”, “driver_license”, “identity_card”, “internal_passport”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration” and “temporary_registration” types. Files can be decrypted and verified using the accompanying EncryptedCredentials.
-     *
-     * This method overrides the default getTranslation method
-     * and returns a nice array of PassportFile objects.
-     *
-     * @return null|PassportFile[]
-     */
-    public function getTranslation()
-    {
-        $pretty_array = $this->makePrettyObjectArray(PassportFile::class, 'translation');
-
-        return empty($pretty_array) ? null : $pretty_array;
-    }
 }

src/Entities/TelegramPassport/PassportData.php

@@ -19,7 +19,8 @@ use Longman\TelegramBot\Entities\Entity;
  *
  * @link https://core.telegram.org/bots/api#passportdata
  *
- * @method EncryptedCredentials getCredentials() Encrypted credentials required to decrypt the data
+ * @method EncryptedPassportElement[] getData()        Array with information about documents and other Telegram Passport elements that was shared with the bot
+ * @method EncryptedCredentials       getCredentials() Encrypted credentials required to decrypt the data
  **/
 class PassportData extends Entity
 {
@@ -29,23 +30,8 @@ class PassportData extends Entity
     protected function subEntities()
     {
         return [
-            'data'        => EncryptedPassportElement::class,
+            'data'        => [EncryptedPassportElement::class],
             'credentials' => EncryptedCredentials::class,
         ];
     }
-
-    /**
-     * Array with information about documents and other Telegram Passport elements that was shared with the bot
-     *
-     * This method overrides the default getData method
-     * and returns a nice array of EncryptedPassportElement objects.
-     *
-     * @return null|EncryptedPassportElement[]
-     */
-    public function getData()
-    {
-        $pretty_array = $this->makePrettyObjectArray(EncryptedPassportElement::class, 'data');
-
-        return empty($pretty_array) ? null : $pretty_array;
-    }
 }

src/Entities/TelegramPassport/PassportElementError/PassportElementErrorDataField.php

@@ -31,8 +31,6 @@ class PassportElementErrorDataField extends Entity implements PassportElementErr
      * PassportElementErrorDataField constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/TelegramPassport/PassportElementError/PassportElementErrorFile.php

@@ -30,8 +30,6 @@ class PassportElementErrorFile extends Entity implements PassportElementError
      * PassportElementErrorFile constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/TelegramPassport/PassportElementError/PassportElementErrorFiles.php

@@ -30,8 +30,6 @@ class PassportElementErrorFiles extends Entity implements PassportElementError
      * PassportElementErrorFiles constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/TelegramPassport/PassportElementError/PassportElementErrorFrontSide.php

@@ -30,8 +30,6 @@ class PassportElementErrorFrontSide extends Entity implements PassportElementErr
      * PassportElementErrorFrontSide constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/TelegramPassport/PassportElementError/PassportElementErrorReverseSide.php

@@ -30,8 +30,6 @@ class PassportElementErrorReverseSide extends Entity implements PassportElementE
      * PassportElementErrorReverseSide constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/TelegramPassport/PassportElementError/PassportElementErrorSelfie.php

@@ -30,8 +30,6 @@ class PassportElementErrorSelfie extends Entity implements PassportElementError
      * PassportElementErrorSelfie constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/TelegramPassport/PassportElementError/PassportElementErrorTranslationFile.php

@@ -30,8 +30,6 @@ class PassportElementErrorTranslationFile extends Entity implements PassportElem
      * PassportElementErrorTranslationFile constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/TelegramPassport/PassportElementError/PassportElementErrorTranslationFiles.php

@@ -30,8 +30,6 @@ class PassportElementErrorTranslationFiles extends Entity implements PassportEle
      * PassportElementErrorTranslationFiles constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/TelegramPassport/PassportElementError/PassportElementErrorUnspecified.php

@@ -30,8 +30,6 @@ class PassportElementErrorUnspecified extends Entity implements PassportElementE
      * PassportElementErrorUnspecified constructor
      *
      * @param array $data
-     *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function __construct(array $data = [])
     {

src/Entities/Update.php

@@ -82,10 +82,7 @@ class Update extends Entity
     /**
      * Get update content
      *
-     * @return \Longman\TelegramBot\Entities\CallbackQuery
-     *         |\Longman\TelegramBot\Entities\ChosenInlineResult
-     *         |\Longman\TelegramBot\Entities\InlineQuery
-     *         |\Longman\TelegramBot\Entities\Message
+     * @return CallbackQuery|ChosenInlineResult|InlineQuery|Message
      */
     public function getUpdateContent()
     {

src/Entities/UserProfilePhotos.php

@@ -34,7 +34,7 @@ class UserProfilePhotos extends Entity
      *
      * This method overrides the default getPhotos method and returns a nice array
      *
-     * @return PhotoSize[]
+     * @return PhotoSize[][]
      */
     public function getPhotos()
     {
@@ -42,11 +42,9 @@ class UserProfilePhotos extends Entity
 
         if ($these_photos = $this->getProperty('photos')) {
             foreach ($these_photos as $photos) {
-                $new_photos = [];
-                foreach ($photos as $photo) {
-                    $new_photos[] = new PhotoSize($photo);
-                }
-                $all_photos[] = $new_photos;
+                $all_photos[] = array_map(function ($photo) {
+                    return new PhotoSize($photo);
+                }, $photos);
             }
         }
 

src/Request.php

@@ -91,7 +91,7 @@ class Request
     /**
      * Telegram object
      *
-     * @var \Longman\TelegramBot\Telegram
+     * @var Telegram
      */
     private static $telegram;
 
@@ -105,7 +105,7 @@ class Request
     /**
      * Guzzle Client object
      *
-     * @var \GuzzleHttp\Client
+     * @var Client
      */
     private static $client;
 
@@ -253,7 +253,7 @@ class Request
     /**
      * Initialize
      *
-     * @param \Longman\TelegramBot\Telegram $telegram
+     * @param Telegram $telegram
      *
      * @throws TelegramException
      */
@@ -287,7 +287,7 @@ class Request
      * Set input from custom input or stdin and return it
      *
      * @return string
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     public static function getInput()
     {
@@ -377,7 +377,7 @@ class Request
             }
 
             // Reformat data array in multipart way if it contains a resource
-            $has_resource |= (is_resource($item) || $item instanceof Stream);
+            $has_resource = $has_resource || is_resource($item) || $item instanceof Stream;
             $multipart[]  = ['name' => $key, 'contents' => $item];
         }
 
@@ -421,6 +421,7 @@ class Request
      * @param array $multipart
      *
      * @return mixed
+     * @throws TelegramException
      */
     private static function mediaInputHelper($item, &$has_resource, array &$multipart)
     {
@@ -472,7 +473,7 @@ class Request
      * @param array  $data   Data to attach to the execution
      *
      * @return string Result of the HTTP Request
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     public static function execute($action, array $data = [])
     {
@@ -509,10 +510,10 @@ class Request
     /**
      * Download file
      *
-     * @param \Longman\TelegramBot\Entities\File $file
+     * @param File $file
      *
      * @return boolean
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     public static function downloadFile(File $file)
     {
@@ -540,7 +541,7 @@ class Request
 
             return filesize($file_path) > 0;
         } catch (RequestException $e) {
-            return ($e->getResponse()) ? (string) $e->getResponse()->getBody() : '';
+            return false;
         } finally {
             //Logging verbose debug output
             TelegramLog::endDebugLogTempStream('Verbose HTTP File Download Request output:' . PHP_EOL . '%s' . PHP_EOL);
@@ -553,7 +554,7 @@ class Request
      * @param string $file
      *
      * @return resource
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     public static function encodeFile($file)
     {
@@ -574,8 +575,8 @@ class Request
      * @param string $action
      * @param array  $data
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public static function send($action, array $data = [])
     {
@@ -643,7 +644,7 @@ class Request
      *
      * @param array $data
      *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     private static function ensureNonEmptyData(array $data)
     {
@@ -657,7 +658,7 @@ class Request
      *
      * @param string $action
      *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     private static function ensureValidAction($action)
     {
@@ -673,8 +674,8 @@ class Request
      *
      * @param array $data
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public static function sendMessage(array $data)
     {
@@ -698,8 +699,7 @@ class Request
      * @param string $action
      * @param array  $data
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
      */
     public static function __callStatic($action, array $data)
     {
@@ -716,8 +716,7 @@ class Request
      * No request to telegram are sent, this function is used in commands that
      * don't need to fire a message after execution
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
      */
     public static function emptyResponse()
     {
@@ -760,7 +759,7 @@ class Request
      * @param boolean $enable
      * @param array   $options
      *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     public static function setLimiter($enable = true, array $options = [])
     {
@@ -789,7 +788,7 @@ class Request
      * @param string $action
      * @param array  $data
      *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     private static function limitTelegramRequests($action, array $data = [])
     {
@@ -830,7 +829,7 @@ class Request
             $chat_id           = isset($data['chat_id']) ? $data['chat_id'] : null;
             $inline_message_id = isset($data['inline_message_id']) ? $data['inline_message_id'] : null;
 
-            if (($chat_id || $inline_message_id) && in_array($action, $limited_methods)) {
+            if (($chat_id || $inline_message_id) && in_array($action, $limited_methods, true)) {
                 $timeout = 60;
 
                 while (true) {
@@ -838,18 +837,23 @@ class Request
                         throw new TelegramException('Timed out while waiting for a request spot!');
                     }
 
-                    $requests = DB::getTelegramRequestCount($chat_id, $inline_message_id);
+                    if (!($requests = DB::getTelegramRequestCount($chat_id, $inline_message_id))) {
+                        break;
+                    }
+
+                    // Make sure we're handling integers here.
+                    $requests = array_map('intval', $requests);
 
-                    $chat_per_second   = ($requests['LIMIT_PER_SEC'] == 0); // No more than one message per second inside a particular chat
-                    $global_per_second = ($requests['LIMIT_PER_SEC_ALL'] < 30);    // No more than 30 messages per second to different chats
-                    $groups_per_minute = (((is_numeric($chat_id) && $chat_id > 0) || !is_null($inline_message_id)) || ((!is_numeric($chat_id) || $chat_id < 0) && $requests['LIMIT_PER_MINUTE'] < 20));    // No more than 20 messages per minute in groups and channels
+                    $chat_per_second   = ($requests['LIMIT_PER_SEC'] === 0);    // No more than one message per second inside a particular chat
+                    $global_per_second = ($requests['LIMIT_PER_SEC_ALL'] < 30); // No more than 30 messages per second to different chats
+                    $groups_per_minute = (((is_numeric($chat_id) && $chat_id > 0) || $inline_message_id !== null) || ((!is_numeric($chat_id) || $chat_id < 0) && $requests['LIMIT_PER_MINUTE'] < 20));    // No more than 20 messages per minute in groups and channels
 
                     if ($chat_per_second && $global_per_second && $groups_per_minute) {
                         break;
                     }
 
                     $timeout--;
-                    usleep(self::$limiter_interval * 1000000);
+                    usleep((int) (self::$limiter_interval * 1000000));
                 }
 
                 DB::insertTelegramRequest($action, $data);

src/Telegram.php

@@ -70,7 +70,7 @@ class Telegram
     /**
      * Current Update object
      *
-     * @var \Longman\TelegramBot\Entities\Update
+     * @var Update
      */
     protected $update;
 
@@ -98,7 +98,7 @@ class Telegram
     /**
      * PDO object
      *
-     * @var \PDO
+     * @var PDO
      */
     protected $pdo;
 
@@ -119,7 +119,7 @@ class Telegram
     /**
      * ServerResponse of the last Command execution
      *
-     * @var \Longman\TelegramBot\Entities\ServerResponse
+     * @var ServerResponse
      */
     protected $last_command_response;
 
@@ -151,7 +151,7 @@ class Telegram
      * @param string $api_key
      * @param string $bot_username
      *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     public function __construct($api_key, $bot_username = '')
     {
@@ -182,8 +182,8 @@ class Telegram
      * @param string $table_prefix
      * @param string $encoding
      *
-     * @return \Longman\TelegramBot\Telegram
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return Telegram
+     * @throws TelegramException
      */
     public function enableMySql(array $credential, $table_prefix = null, $encoding = 'utf8mb4')
     {
@@ -200,8 +200,8 @@ class Telegram
      * @param PDO    $external_pdo_connection PDO database object
      * @param string $table_prefix
      *
-     * @return \Longman\TelegramBot\Telegram
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return Telegram
+     * @throws TelegramException
      */
     public function enableExternalMySql($external_pdo_connection, $table_prefix = null)
     {
@@ -216,7 +216,7 @@ class Telegram
      * Get commands list
      *
      * @return array $commands
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     public function getCommandsList()
     {
@@ -261,7 +261,7 @@ class Telegram
      *
      * @param string $command
      *
-     * @return \Longman\TelegramBot\Commands\Command|null
+     * @return Command|null
      */
     public function getCommandObject($command)
     {
@@ -284,7 +284,7 @@ class Telegram
      *
      * @param string $input (json format)
      *
-     * @return \Longman\TelegramBot\Telegram
+     * @return Telegram
      */
     public function setCustomInput($input)
     {
@@ -306,7 +306,7 @@ class Telegram
     /**
      * Get the ServerResponse of the last Command execution
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
+     * @return ServerResponse
      */
     public function getLastCommandResponse()
     {
@@ -319,8 +319,8 @@ class Telegram
      * @param int|null $limit
      * @param int|null $timeout
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function handleGetUpdates($limit = null, $timeout = null)
     {
@@ -344,9 +344,8 @@ class Telegram
         if ($custom_input = $this->getCustomInput()) {
             $response = new ServerResponse(json_decode($custom_input, true), $this->bot_username);
         } else {
-            if (DB::isDbConnected()) {
+            if (DB::isDbConnected() && $last_update = DB::selectTelegramUpdate(1)) {
                 //Get last update id from the database
-                $last_update = DB::selectTelegramUpdate(1);
                 $last_update = reset($last_update);
 
                 $this->last_update_id = isset($last_update['id']) ? $last_update['id'] : null;
@@ -394,7 +393,7 @@ class Telegram
      *
      * @return bool
      *
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     public function handle()
     {
@@ -435,14 +434,14 @@ class Telegram
     /**
      * Process bot Update request
      *
-     * @param \Longman\TelegramBot\Entities\Update $update
+     * @param Update $update
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function processUpdate(Update $update)
     {
-        $this->update = $update;
+        $this->update         = $update;
         $this->last_update_id = $update->getUpdateId();
 
         //Load admin commands
@@ -494,7 +493,7 @@ class Telegram
      * @param string $command
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     public function executeCommand($command)
     {
@@ -535,12 +534,12 @@ class Telegram
      *
      * @param integer $admin_id Single admin id
      *
-     * @return \Longman\TelegramBot\Telegram
+     * @return Telegram
      */
     public function enableAdmin($admin_id)
     {
         if (!is_int($admin_id) || $admin_id <= 0) {
-            TelegramLog::error('Invalid value "%s" for admin.', $admin_id);
+            TelegramLog::error('Invalid value "' . $admin_id . '" for admin.');
         } elseif (!in_array($admin_id, $this->admins_list, true)) {
             $this->admins_list[] = $admin_id;
         }
@@ -553,7 +552,7 @@ class Telegram
      *
      * @param array $admin_ids List of admin ids
      *
-     * @return \Longman\TelegramBot\Telegram
+     * @return Telegram
      */
     public function enableAdmins(array $admin_ids)
     {
@@ -628,12 +627,12 @@ class Telegram
      * @param string $path   Custom commands path to add
      * @param bool   $before If the path should be prepended or appended to the list
      *
-     * @return \Longman\TelegramBot\Telegram
+     * @return Telegram
      */
     public function addCommandsPath($path, $before = true)
     {
         if (!is_dir($path)) {
-            TelegramLog::error('Commands path "%s" does not exist.', $path);
+            TelegramLog::error('Commands path "' . $path . '" does not exist.');
         } elseif (!in_array($path, $this->commands_paths, true)) {
             if ($before) {
                 array_unshift($this->commands_paths, $path);
@@ -651,7 +650,7 @@ class Telegram
      * @param array $paths  Custom commands paths to add
      * @param bool  $before If the paths should be prepended or appended to the list
      *
-     * @return \Longman\TelegramBot\Telegram
+     * @return Telegram
      */
     public function addCommandsPaths(array $paths, $before = true)
     {
@@ -677,7 +676,7 @@ class Telegram
      *
      * @param string $path Custom upload path
      *
-     * @return \Longman\TelegramBot\Telegram
+     * @return Telegram
      */
     public function setUploadPath($path)
     {
@@ -701,7 +700,7 @@ class Telegram
      *
      * @param string $path Custom download path
      *
-     * @return \Longman\TelegramBot\Telegram
+     * @return Telegram
      */
     public function setDownloadPath($path)
     {
@@ -730,7 +729,7 @@ class Telegram
      * @param string $command
      * @param array  $config
      *
-     * @return \Longman\TelegramBot\Telegram
+     * @return Telegram
      */
     public function setCommandConfig($command, array $config)
     {
@@ -797,8 +796,8 @@ class Telegram
      * @param string $url
      * @param array  $data Optional parameters.
      *
-     * @return \Longman\TelegramBot\Entities\ServerResponse
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @return ServerResponse
+     * @throws TelegramException
      */
     public function setWebhook($url, array $data = [])
     {
@@ -833,7 +832,7 @@ class Telegram
      * Delete any assigned webhook
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
+     * @throws TelegramException
      */
     public function deleteWebhook()
     {
@@ -878,9 +877,10 @@ class Telegram
     /**
      * Enable requests limiter
      *
-     * @param  array $options
+     * @param array $options
      *
-     * @return \Longman\TelegramBot\Telegram
+     * @return Telegram
+     * @throws TelegramException
      */
     public function enableLimiter(array $options = [])
     {
@@ -902,7 +902,7 @@ class Telegram
             throw new TelegramException('No command(s) provided!');
         }
 
-        $this->run_commands  = true;
+        $this->run_commands = true;
 
         $result = Request::getMe();
 

src/TelegramLog.php

@@ -10,31 +10,50 @@
 
 namespace Longman\TelegramBot;
 
+use Exception;
 use Longman\TelegramBot\Exception\TelegramLogException;
 use Monolog\Formatter\LineFormatter;
 use Monolog\Handler\StreamHandler;
 use Monolog\Logger;
+use Psr\Log\LoggerInterface;
+use Psr\Log\NullLogger;
 
+/**
+ * Class TelegramLog
+ *
+ * @todo Clean out all deprecated code in the near future!
+ *
+ * @method static void emergency(string $message, array $context = [])
+ * @method static void alert(string $message, array $context = [])
+ * @method static void critical(string $message, array $context = [])
+ * @method static void error(string $message, array $context = [])
+ * @method static void warning(string $message, array $context = [])
+ * @method static void notice(string $message, array $context = [])
+ * @method static void info(string $message, array $context = [])
+ * @method static void debug(string $message, array $context = [])
+ * @method static void update(string $message, array $context = [])
+ */
 class TelegramLog
 {
     /**
-     * Monolog instance
+     * Logger instance
      *
-     * @var \Monolog\Logger
+     * @var LoggerInterface|Logger
      */
-    protected static $monolog;
+    protected static $logger;
 
     /**
-     * Monolog instance for update
+     * Logger instance for update
      *
-     * @var \Monolog\Logger
+     * @var LoggerInterface|Logger
      */
-    protected static $monolog_update;
+    protected static $update_logger;
 
     /**
      * Path for error log
      *
      * @var string
+     * @deprecated
      */
     protected static $error_log_path;
 
@@ -42,6 +61,7 @@ class TelegramLog
      * Path for debug log
      *
      * @var string
+     * @deprecated
      */
     protected static $debug_log_path;
 
@@ -49,6 +69,7 @@ class TelegramLog
      * Path for update log
      *
      * @var string
+     * @deprecated
      */
     protected static $update_log_path;
 
@@ -60,80 +81,126 @@ class TelegramLog
     protected static $debug_log_temp_stream_handle;
 
     /**
-     * Initialize Monolog Logger instance, optionally passing an existing one
-     *
-     * @param \Monolog\Logger
+     * Initialise Logger instance, optionally passing an existing one.
      *
-     * @return \Monolog\Logger
+     * @param LoggerInterface|null $logger
+     * @param LoggerInterface|null $update_logger
      */
-    public static function initialize(Logger $external_monolog = null)
+    public static function initialize(LoggerInterface $logger = null, LoggerInterface $update_logger = null)
     {
-        if (self::$monolog === null) {
-            if ($external_monolog !== null) {
-                self::$monolog = $external_monolog;
-
-                foreach (self::$monolog->getHandlers() as $handler) {
-                    if (method_exists($handler, 'getLevel') && $handler->getLevel() === 400) {
-                        self::$error_log_path = 'true';
-                    }
-                    if (method_exists($handler, 'getLevel') && $handler->getLevel() === 100) {
-                        self::$debug_log_path = 'true';
-                    }
+        // Clearly deprecated code still being executed.
+        if ($logger === null) {
+            (defined('PHPUNIT_TESTSUITE') && PHPUNIT_TESTSUITE) || trigger_error('A PSR-3 compatible LoggerInterface object must be provided. Initialise with a preconfigured logger instance.', E_USER_DEPRECATED);
+            $logger = new Logger('bot_log');
+        } elseif ($logger instanceof Logger) {
+            foreach ($logger->getHandlers() as $handler) {
+                if (method_exists($handler, 'getLevel') && $handler->getLevel() === Logger::ERROR) {
+                    self::$error_log_path = 'true';
+                }
+                if (method_exists($handler, 'getLevel') && $handler->getLevel() === Logger::DEBUG) {
+                    self::$debug_log_path = 'true';
                 }
-            } else {
-                self::$monolog = new Logger('bot_log');
             }
         }
 
-        return self::$monolog;
+        // Fallback to NullLogger.
+        self::$logger        = $logger ?: new NullLogger();
+        self::$update_logger = $update_logger ?: new NullLogger();
     }
 
     /**
-     * Initialize error log
+     * Initialise error log (deprecated)
      *
      * @param string $path
      *
-     * @return \Monolog\Logger
-     * @throws \Longman\TelegramBot\Exception\TelegramLogException
-     * @throws \InvalidArgumentException
-     * @throws \Exception
+     * @return LoggerInterface
+     * @throws Exception
+     *
+     * @deprecated Initialise a preconfigured logger instance instead.
      */
     public static function initErrorLog($path)
     {
+        (defined('PHPUNIT_TESTSUITE') && PHPUNIT_TESTSUITE) || trigger_error(__METHOD__ . ' is deprecated and will be removed soon. Initialise with a preconfigured logger instance instead using "TelegramLog::initialize($logger)".', E_USER_DEPRECATED);
+
         if ($path === null || $path === '') {
             throw new TelegramLogException('Empty path for error log');
         }
         self::initialize();
-        self::$error_log_path = $path;
 
-        return self::$monolog->pushHandler(
-            (new StreamHandler(self::$error_log_path, Logger::ERROR))
-                ->setFormatter(new LineFormatter(null, null, true))
-        );
+        // Deprecated code used as fallback.
+        if (self::$logger instanceof Logger) {
+            self::$error_log_path = $path;
+
+            self::$logger->pushHandler(
+                (new StreamHandler(self::$error_log_path, Logger::ERROR))
+                    ->setFormatter(new LineFormatter(null, null, true))
+            );
+        }
+
+        return self::$logger;
     }
 
     /**
-     * Initialize debug log
+     * Initialise debug log (deprecated)
      *
      * @param string $path
      *
-     * @return \Monolog\Logger
-     * @throws \Longman\TelegramBot\Exception\TelegramLogException
-     * @throws \InvalidArgumentException
-     * @throws \Exception
+     * @return LoggerInterface
+     * @throws Exception
+     *
+     * @deprecated Initialise a preconfigured logger instance instead.
      */
     public static function initDebugLog($path)
     {
+        (defined('PHPUNIT_TESTSUITE') && PHPUNIT_TESTSUITE) || trigger_error(__METHOD__ . ' is deprecated and will be removed soon. Initialise with a preconfigured logger instance instead using "TelegramLog::initialize($logger)".', E_USER_DEPRECATED);
+
         if ($path === null || $path === '') {
             throw new TelegramLogException('Empty path for debug log');
         }
         self::initialize();
-        self::$debug_log_path = $path;
 
-        return self::$monolog->pushHandler(
-            (new StreamHandler(self::$debug_log_path, Logger::DEBUG))
-                ->setFormatter(new LineFormatter(null, null, true))
-        );
+        // Deprecated code used as fallback.
+        if (self::$logger instanceof Logger) {
+            self::$debug_log_path = $path;
+
+            self::$logger->pushHandler(
+                (new StreamHandler(self::$debug_log_path, Logger::DEBUG))
+                    ->setFormatter(new LineFormatter(null, null, true))
+            );
+        }
+
+        return self::$logger;
+    }
+
+    /**
+     * Initialise update log (deprecated)
+     *
+     * @param string $path
+     *
+     * @return LoggerInterface
+     * @throws Exception
+     *
+     * @deprecated Initialise a preconfigured logger instance instead.
+     */
+    public static function initUpdateLog($path)
+    {
+        (defined('PHPUNIT_TESTSUITE') && PHPUNIT_TESTSUITE) || trigger_error(__METHOD__ . ' is deprecated and will be removed soon. Initialise with a preconfigured logger instance instead using "TelegramLog::initialize($logger)".', E_USER_DEPRECATED);
+
+        if ($path === null || $path === '') {
+            throw new TelegramLogException('Empty path for update log');
+        }
+        self::$update_log_path = $path;
+
+        if (self::$update_logger === null || self::$update_logger instanceof NullLogger) {
+            self::$update_logger = new Logger('bot_update_log');
+
+            self::$update_logger->pushHandler(
+                (new StreamHandler(self::$update_log_path, Logger::INFO))
+                    ->setFormatter(new LineFormatter('%message%' . PHP_EOL))
+            );
+        }
+
+        return self::$update_logger;
     }
 
     /**
@@ -143,11 +210,8 @@ class TelegramLog
      */
     public static function getDebugLogTempStream()
     {
-        if (self::$debug_log_temp_stream_handle === null) {
-            if (!self::isDebugLogActive()) {
-                return false;
-            }
-            self::$debug_log_temp_stream_handle = fopen('php://temp', 'w+b');
+        if ((self::$debug_log_temp_stream_handle === null) && $temp_stream_handle = fopen('php://temp', 'wb+')) {
+            self::$debug_log_temp_stream_handle = $temp_stream_handle;
         }
 
         return self::$debug_log_temp_stream_handle;
@@ -162,48 +226,22 @@ class TelegramLog
     {
         if (is_resource(self::$debug_log_temp_stream_handle)) {
             rewind(self::$debug_log_temp_stream_handle);
-            self::debug($message, stream_get_contents(self::$debug_log_temp_stream_handle));
+            self::debug(sprintf($message, stream_get_contents(self::$debug_log_temp_stream_handle)));
             fclose(self::$debug_log_temp_stream_handle);
             self::$debug_log_temp_stream_handle = null;
         }
     }
 
-    /**
-     * Initialize update log
-     *
-     * @param string $path
-     *
-     * @return \Monolog\Logger
-     * @throws \Longman\TelegramBot\Exception\TelegramLogException
-     * @throws \InvalidArgumentException
-     * @throws \Exception
-     */
-    public static function initUpdateLog($path)
-    {
-        if ($path === null || $path === '') {
-            throw new TelegramLogException('Empty path for update log');
-        }
-        self::$update_log_path = $path;
-
-        if (self::$monolog_update === null) {
-            self::$monolog_update = new Logger('bot_update_log');
-
-            self::$monolog_update->pushHandler(
-                (new StreamHandler(self::$update_log_path, Logger::INFO))
-                    ->setFormatter(new LineFormatter('%message%' . PHP_EOL))
-            );
-        }
-
-        return self::$monolog_update;
-    }
-
     /**
      * Is error log active
      *
      * @return bool
+     *
+     * @deprecated Initialise a preconfigured logger instance instead.
      */
     public static function isErrorLogActive()
     {
+        (defined('PHPUNIT_TESTSUITE') && PHPUNIT_TESTSUITE) || trigger_error(__METHOD__ . ' is deprecated and will be removed soon. Initialise with a preconfigured logger instance instead using "TelegramLog::initialize($logger)".', E_USER_DEPRECATED);
         return self::$error_log_path !== null;
     }
 
@@ -211,9 +249,12 @@ class TelegramLog
      * Is debug log active
      *
      * @return bool
+     *
+     * @deprecated Initialise a preconfigured logger instance instead.
      */
     public static function isDebugLogActive()
     {
+        (defined('PHPUNIT_TESTSUITE') && PHPUNIT_TESTSUITE) || trigger_error(__METHOD__ . ' is deprecated and will be removed soon. Initialise with a preconfigured logger instance instead using "TelegramLog::initialize($logger)".', E_USER_DEPRECATED);
         return self::$debug_log_path !== null;
     }
 
@@ -221,69 +262,71 @@ class TelegramLog
      * Is update log active
      *
      * @return bool
+     *
+     * @deprecated Initialise a preconfigured logger instance instead.
      */
     public static function isUpdateLogActive()
     {
+        (defined('PHPUNIT_TESTSUITE') && PHPUNIT_TESTSUITE) || trigger_error(__METHOD__ . ' is deprecated and will be removed soon. Initialise with a preconfigured logger instance instead using "TelegramLog::initialize($logger)".', E_USER_DEPRECATED);
         return self::$update_log_path !== null;
     }
 
     /**
-     * Report error log
+     * Handle any logging method call.
      *
-     * @param string $text
+     * @param string $name
+     * @param array  $arguments
      */
-    public static function error($text)
+    public static function __callStatic($name, array $arguments)
     {
-        if (self::isErrorLogActive()) {
-            $text = self::getLogText($text, func_get_args());
-            self::$monolog->error($text);
+        // Get the correct logger instance.
+        $logger = null;
+        if (in_array($name, ['emergency', 'alert', 'critical', 'error', 'warning', 'notice', 'info', 'debug',], true)) {
+            $logger = self::$logger;
+        } elseif ($name === 'update') {
+            $logger = self::$update_logger;
+            $name   = 'info';
+        } else {
+            return;
         }
-    }
 
-    /**
-     * Report debug log
-     *
-     * @param string $text
-     */
-    public static function debug($text)
-    {
-        if (self::isDebugLogActive()) {
-            $text = self::getLogText($text, func_get_args());
-            self::$monolog->debug($text);
-        }
-    }
+        self::initialize(self::$logger, self::$update_logger);
 
-    /**
-     * Report update log
-     *
-     * @param string $text
-     */
-    public static function update($text)
-    {
-        if (self::isUpdateLogActive()) {
-            $text = self::getLogText($text, func_get_args());
-            self::$monolog_update->info($text);
+        // Replace any placeholders from the passed context.
+        if (count($arguments) >= 2) {
+            if (is_array($arguments[1])) {
+                $arguments[0] = self::interpolate($arguments[0], $arguments[1]);
+            } else {
+                // @todo Old parameter passing active, should be removed in the near future.
+                $arguments[0] = vsprintf($arguments[0], array_splice($arguments, 1));
+            }
         }
+
+        call_user_func_array([$logger, $name], $arguments);
     }
 
     /**
-     * Applies vsprintf to the text if placeholder replacements are passed along.
+     * Interpolates context values into the message placeholders.
+     *
+     * @see https://www.php-fig.org/psr/psr-3/#12-message
      *
-     * @param string $text
-     * @param array  $args
+     * @param string $message
+     * @param array  $context
      *
      * @return string
      */
-    protected static function getLogText($text, array $args = [])
+    protected static function interpolate($message, array $context = [])
     {
-        // Pop the $text off the array, as it gets passed via func_get_args().
-        array_shift($args);
-
-        // If no placeholders have been passed, don't parse the text.
-        if (empty($args)) {
-            return $text;
+        // build a replacement array with braces around the context keys
+        $replace = [];
+        foreach ($context as $key => $val) {
+            // check that the value can be casted to string
+            if (!is_array($val) && (!is_object($val) || method_exists($val, '__toString'))) {
+                $replace['{' . $key . '}'] = $val;
+            }
         }
 
-        return vsprintf($text, $args);
+        // interpolate replacement values into the message and return
+        return strtr($message, $replace);
     }
 }

tests/unit/Commands/CommandTest.php

@@ -10,6 +10,7 @@
 
 namespace Longman\TelegramBot\Tests\Unit\Commands;
 
+use Longman\TelegramBot\Commands\Command;
 use Longman\TelegramBot\Telegram;
 use Longman\TelegramBot\Tests\Unit\TestCase;
 use Longman\TelegramBot\Tests\Unit\TestHelpers;
@@ -26,25 +27,25 @@ class CommandTest extends TestCase
     /**
      * @var string
      */
-    private $command_namespace = 'Longman\TelegramBot\Commands\Command';
+    private $command_namespace = Command::class;
 
     /**
-     * @var \Longman\TelegramBot\Telegram
+     * @var Telegram
      */
     private $telegram;
 
     /**
-     * @var \Longman\TelegramBot\Commands\Command
+     * @var Command
      */
     private $command_stub;
 
     /**
-     * @var \Longman\TelegramBot\Telegram
+     * @var Telegram
      */
     private $telegram_with_config;
 
     /**
-     * @var \Longman\TelegramBot\Commands\Command
+     * @var Command
      */
     private $command_stub_with_config;
 

tests/unit/Commands/CommandTestCase.php

@@ -10,6 +10,7 @@
 
 namespace Longman\TelegramBot\Tests\Unit\Commands;
 
+use Longman\TelegramBot\Commands\Command;
 use Longman\TelegramBot\Telegram;
 use Longman\TelegramBot\Tests\Unit\TestCase;
 
@@ -23,12 +24,12 @@ use Longman\TelegramBot\Tests\Unit\TestCase;
 class CommandTestCase extends TestCase
 {
     /**
-     * @var \Longman\TelegramBot\Telegram
+     * @var Telegram
      */
     protected $telegram;
 
     /**
-     * @var \Longman\TelegramBot\Commands\Command
+     * @var Command
      */
     protected $command;
 

tests/unit/Commands/CustomTestCommands/HiddenCommand.php

@@ -47,7 +47,6 @@ class HiddenCommand extends UserCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

tests/unit/Commands/CustomTestCommands/VisibleCommand.php

@@ -47,7 +47,6 @@ class VisibleCommand extends UserCommand
      * Command execute method
      *
      * @return mixed
-     * @throws \Longman\TelegramBot\Exception\TelegramException
      */
     public function execute()
     {

tests/unit/ConversationTest.php

@@ -23,7 +23,7 @@ use Longman\TelegramBot\Telegram;
 class ConversationTest extends TestCase
 {
     /**
-     * @var \Longman\TelegramBot\Telegram
+     * @var Telegram
      */
     private $telegram;
 
@@ -53,7 +53,7 @@ class ConversationTest extends TestCase
 
     public function testConversationThatExistsPropertiesSetCorrectly()
     {
-        $info = TestHelpers::startFakeConversation();
+        $info         = TestHelpers::startFakeConversation();
         $conversation = new Conversation($info['user_id'], $info['chat_id'], 'command');
         $this->assertAttributeEquals($info['user_id'], 'user_id', $conversation);
         $this->assertAttributeEquals($info['chat_id'], 'chat_id', $conversation);
@@ -85,7 +85,7 @@ class ConversationTest extends TestCase
 
     public function testNewConversationThatWillExistWithCommand()
     {
-        $info = TestHelpers::startFakeConversation();
+        $info         = TestHelpers::startFakeConversation();
         $conversation = new Conversation($info['user_id'], $info['chat_id'], 'command');
         $this->assertTrue($conversation->exists());
         $this->assertEquals('command', $conversation->getCommand());
@@ -93,7 +93,7 @@ class ConversationTest extends TestCase
 
     public function testStopConversation()
     {
-        $info = TestHelpers::startFakeConversation();
+        $info         = TestHelpers::startFakeConversation();
         $conversation = new Conversation($info['user_id'], $info['chat_id'], 'command');
         $this->assertTrue($conversation->exists());
         $conversation->stop();
@@ -104,7 +104,7 @@ class ConversationTest extends TestCase
 
     public function testCancelConversation()
     {
-        $info = TestHelpers::startFakeConversation();
+        $info         = TestHelpers::startFakeConversation();
         $conversation = new Conversation($info['user_id'], $info['chat_id'], 'command');
         $this->assertTrue($conversation->exists());
         $conversation->cancel();
@@ -115,8 +115,8 @@ class ConversationTest extends TestCase
 
     public function testUpdateConversationNotes()
     {
-        $info = TestHelpers::startFakeConversation();
-        $conversation = new Conversation($info['user_id'], $info['chat_id'], 'command');
+        $info                = TestHelpers::startFakeConversation();
+        $conversation        = new Conversation($info['user_id'], $info['chat_id'], 'command');
         $conversation->notes = 'newnote';
         $conversation->update();
 

tests/unit/Entities/AudioTest.php

@@ -34,7 +34,7 @@ class AudioTest extends TestCase
     public function testInstance()
     {
         $audio = new Audio($this->record);
-        self::assertInstanceOf('Longman\TelegramBot\Entities\Audio', $audio);
+        self::assertInstanceOf(Audio::class, $audio);
     }
 
     public function testGetProperties()

tests/unit/Entities/FileTest.php

@@ -38,7 +38,7 @@ class FileTest extends TestCase
     public function testBaseStageLocation()
     {
         $file = new File($this->data);
-        $this->assertInstanceOf('Longman\TelegramBot\Entities\File', $file);
+        $this->assertInstanceOf(File::class, $file);
     }
 
     public function testGetFileId()

tests/unit/Entities/LocationTest.php

@@ -34,7 +34,7 @@ class LocationTest extends TestCase
     public function testBaseStageLocation()
     {
         $location = new Location($this->coordinates);
-        $this->assertInstanceOf('Longman\TelegramBot\Entities\Location', $location);
+        $this->assertInstanceOf(Location::class, $location);
     }
 
     public function testGetLongitude()

tests/unit/Entities/ServerResponseTest.php

@@ -12,8 +12,14 @@
 
 namespace Longman\TelegramBot\Tests\Unit;
 
+use Longman\TelegramBot\Entities\File;
 use Longman\TelegramBot\Entities\Message;
+use Longman\TelegramBot\Entities\PhotoSize;
 use Longman\TelegramBot\Entities\ServerResponse;
+use Longman\TelegramBot\Entities\Sticker;
+use Longman\TelegramBot\Entities\StickerSet;
+use Longman\TelegramBot\Entities\Update;
+use Longman\TelegramBot\Entities\UserProfilePhotos;
 use Longman\TelegramBot\Request;
 
 /**
@@ -54,7 +60,7 @@ class ServerResponseTest extends TestCase
         self::assertTrue($server->isOk());
         self::assertNull($server->getErrorCode());
         self::assertNull($server->getDescription());
-        self::assertInstanceOf('\Longman\TelegramBot\Entities\Message', $server_result);
+        self::assertInstanceOf(Message::class, $server_result);
 
         //Message
         self::assertEquals('1234', $server_result->getMessageId());
@@ -181,7 +187,7 @@ class ServerResponseTest extends TestCase
         $server = new ServerResponse(json_decode($result, true), 'testbot');
 
         self::assertCount(4, $server->getResult());
-        self::assertInstanceOf('\Longman\TelegramBot\Entities\Update', $server->getResult()[0]);
+        self::assertInstanceOf(Update::class, $server->getResult()[0]);
     }
 
     public function getUpdatesEmpty()
@@ -239,8 +245,8 @@ class ServerResponseTest extends TestCase
         //Photo size count
         self::assertCount(3, $photos[0]);
 
-        self::assertInstanceOf('\Longman\TelegramBot\Entities\UserProfilePhotos', $server_result);
-        self::assertInstanceOf('\Longman\TelegramBot\Entities\PhotoSize', $photos[0][0]);
+        self::assertInstanceOf(UserProfilePhotos::class, $server_result);
+        self::assertInstanceOf(PhotoSize::class, $photos[0][0]);
     }
 
     public function getFile()
@@ -261,7 +267,7 @@ class ServerResponseTest extends TestCase
         $result = $this->getFile();
         $server = new ServerResponse(json_decode($result, true), 'testbot');
 
-        self::assertInstanceOf('\Longman\TelegramBot\Entities\File', $server->getResult());
+        self::assertInstanceOf(File::class, $server->getResult());
     }
 
     public function testSetGeneralTestFakeResponse()
@@ -287,7 +293,7 @@ class ServerResponseTest extends TestCase
         self::assertTrue($server->isOk());
         self::assertNull($server->getErrorCode());
         self::assertNull($server->getDescription());
-        self::assertInstanceOf('\Longman\TelegramBot\Entities\Message', $server_result);
+        self::assertInstanceOf(Message::class, $server_result);
 
         //Message
         self::assertEquals('1234', $server_result->getMessageId());
@@ -306,7 +312,7 @@ class ServerResponseTest extends TestCase
 
         //... they are not finished...
     }
-    
+
     public function getStickerSet()
     {
         TestHelpers::setStaticProperty(Request::class, 'current_action', 'getStickerSet');
@@ -357,21 +363,21 @@ class ServerResponseTest extends TestCase
             }
         }';
     }
-    
+
     public function testGetStickerSet()
     {
         $result = $this->getStickerSet();
         $server = new ServerResponse(json_decode($result, true), 'testbot');
 
         $server_result = $server->getResult();
-        
-        self::assertInstanceOf('\Longman\TelegramBot\Entities\StickerSet', $server_result);
+
+        self::assertInstanceOf(StickerSet::class, $server_result);
         self::assertEquals('stickerset_name', $server_result->getName());
         self::assertEquals('Some name', $server_result->getTitle());
         self::assertFalse($server_result->getContainsMasks());
-        
+
         $stickers = $server_result->getStickers();
         self::assertCount(4, $stickers);
-        self::assertInstanceOf('\Longman\TelegramBot\Entities\Sticker', $stickers[0]);
+        self::assertInstanceOf(Sticker::class, $stickers[0]);
     }
 }

tests/unit/Entities/UserTest.php

@@ -24,7 +24,7 @@ class UserTest extends TestCase
     public function testInstance()
     {
         $user = new User(['id' => 1]);
-        self::assertInstanceOf('Longman\TelegramBot\Entities\User', $user);
+        self::assertInstanceOf(User::class, $user);
     }
 
     public function testGetId()

tests/unit/Entities/WebhookInfoTest.php

@@ -42,7 +42,7 @@ class WebhookInfoTest extends TestCase
     public function testBaseStageWebhookInfo()
     {
         $webhook = new WebhookInfo($this->data);
-        $this->assertInstanceOf('Longman\TelegramBot\Entities\WebhookInfo', $webhook);
+        $this->assertInstanceOf(WebhookInfo::class, $webhook);
     }
 
     public function testGetUrl()

tests/unit/TelegramLogTest.php

@@ -35,8 +35,9 @@ class TelegramLogTest extends TestCase
 
     protected function setUp()
     {
-        // Make sure no monolog instance is set before each test.
-        TestHelpers::setStaticProperty('Longman\TelegramBot\TelegramLog', 'monolog', null);
+        // Make sure no logger instance is set before each test.
+        TestHelpers::setStaticProperty('Longman\TelegramBot\TelegramLog', 'logger', null);
+        TestHelpers::setStaticProperty('Longman\TelegramBot\TelegramLog', 'update_logger', null);
     }
 
     protected function tearDown()
@@ -78,12 +79,14 @@ class TelegramLogTest extends TestCase
         TelegramLog::initErrorLog($file);
         TelegramLog::error('my error');
         TelegramLog::error('my 50% error');
-        TelegramLog::error('my %s error', 'placeholder');
+        TelegramLog::error('my old %s %s error', 'custom', 'placeholder');
+        TelegramLog::error('my new {place} {holder} error', ['place' => 'custom', 'holder' => 'placeholder']);
         $this->assertFileExists($file);
         $error_log = file_get_contents($file);
         $this->assertContains('bot_log.ERROR: my error', $error_log);
         $this->assertContains('bot_log.ERROR: my 50% error', $error_log);
-        $this->assertContains('bot_log.ERROR: my placeholder error', $error_log);
+        $this->assertContains('bot_log.ERROR: my old custom placeholder error', $error_log);
+        $this->assertContains('bot_log.ERROR: my new custom placeholder error', $error_log);
     }
 
     public function testDebugStream()
@@ -93,12 +96,14 @@ class TelegramLogTest extends TestCase
         TelegramLog::initDebugLog($file);
         TelegramLog::debug('my debug');
         TelegramLog::debug('my 50% debug');
-        TelegramLog::debug('my %s debug', 'placeholder');
+        TelegramLog::debug('my old %s %s debug', 'custom', 'placeholder');
+        TelegramLog::debug('my new {place} {holder} debug', ['place' => 'custom', 'holder' => 'placeholder']);
         $this->assertFileExists($file);
         $debug_log = file_get_contents($file);
         $this->assertContains('bot_log.DEBUG: my debug', $debug_log);
         $this->assertContains('bot_log.DEBUG: my 50% debug', $debug_log);
-        $this->assertContains('bot_log.DEBUG: my placeholder debug', $debug_log);
+        $this->assertContains('bot_log.DEBUG: my old custom placeholder debug', $debug_log);
+        $this->assertContains('bot_log.DEBUG: my new custom placeholder debug', $debug_log);
     }
 
     public function testUpdateStream()
@@ -108,12 +113,14 @@ class TelegramLogTest extends TestCase
         TelegramLog::initUpdateLog($file);
         TelegramLog::update('my update');
         TelegramLog::update('my 50% update');
-        TelegramLog::update('my %s update', 'placeholder');
+        TelegramLog::update('my old %s %s update', 'custom', 'placeholder');
+        TelegramLog::update('my new {place} {holder} update', ['place' => 'custom', 'holder' => 'placeholder']);
         $this->assertFileExists($file);
-        $debug_log = file_get_contents($file);
-        $this->assertContains('my update', $debug_log);
-        $this->assertContains('my 50% update', $debug_log);
-        $this->assertContains('my placeholder update', $debug_log);
+        $update_log = file_get_contents($file);
+        $this->assertContains('my update', $update_log);
+        $this->assertContains('my 50% update', $update_log);
+        $this->assertContains('my old custom placeholder update', $update_log);
+        $this->assertContains('my new custom placeholder update', $update_log);
     }
 
     public function testExternalStream()
@@ -121,25 +128,29 @@ class TelegramLogTest extends TestCase
         $file = self::$logfiles['external'];
         $this->assertFileNotExists($file);
 
-        $external_monolog = new Logger('bot_update_log');
+        $external_monolog = new Logger('bot_external_log');
         $external_monolog->pushHandler(new StreamHandler($file, Logger::ERROR));
         $external_monolog->pushHandler(new StreamHandler($file, Logger::DEBUG));
 
         TelegramLog::initialize($external_monolog);
         TelegramLog::error('my error');
         TelegramLog::error('my 50% error');
-        TelegramLog::error('my %s error', 'placeholder');
+        TelegramLog::error('my old %s %s error', 'custom', 'placeholder');
+        TelegramLog::error('my new {place} {holder} error', ['place' => 'custom', 'holder' => 'placeholder']);
         TelegramLog::debug('my debug');
         TelegramLog::debug('my 50% debug');
-        TelegramLog::debug('my %s debug', 'placeholder');
+        TelegramLog::debug('my old %s %s debug', 'custom', 'placeholder');
+        TelegramLog::debug('my new {place} {holder} debug', ['place' => 'custom', 'holder' => 'placeholder']);
 
         $this->assertFileExists($file);
         $file_contents = file_get_contents($file);
-        $this->assertContains('bot_update_log.ERROR: my error', $file_contents);
-        $this->assertContains('bot_update_log.ERROR: my 50% error', $file_contents);
-        $this->assertContains('bot_update_log.ERROR: my placeholder error', $file_contents);
-        $this->assertContains('bot_update_log.DEBUG: my debug', $file_contents);
-        $this->assertContains('bot_update_log.DEBUG: my 50% debug', $file_contents);
-        $this->assertContains('bot_update_log.DEBUG: my placeholder debug', $file_contents);
+        $this->assertContains('bot_external_log.ERROR: my error', $file_contents);
+        $this->assertContains('bot_external_log.ERROR: my 50% error', $file_contents);
+        $this->assertContains('bot_external_log.ERROR: my old custom placeholder error', $file_contents);
+        $this->assertContains('bot_external_log.ERROR: my new custom placeholder error', $file_contents);
+        $this->assertContains('bot_external_log.DEBUG: my debug', $file_contents);
+        $this->assertContains('bot_external_log.DEBUG: my 50% debug', $file_contents);
+        $this->assertContains('bot_external_log.DEBUG: my old custom placeholder debug', $file_contents);
+        $this->assertContains('bot_external_log.DEBUG: my new custom placeholder debug', $file_contents);
     }
 }

tests/unit/TelegramTest.php

@@ -22,7 +22,7 @@ use Longman\TelegramBot\Telegram;
 class TelegramTest extends TestCase
 {
     /**
-     * @var \Longman\TelegramBot\Telegram
+     * @var Telegram
      */
     private $telegram;
 

tests/unit/TestHelpers.php

@@ -85,7 +85,7 @@ class TestHelpers
      *
      * @param array $data Pass custom data array if needed
      *
-     * @return \Longman\TelegramBot\Entities\Update
+     * @return Update
      */
     public static function getFakeUpdateObject($data = null)
     {
@@ -107,7 +107,7 @@ class TestHelpers
      *
      * @param string $command_text
      *
-     * @return \Longman\TelegramBot\Entities\Update
+     * @return Update
      */
     public static function getFakeUpdateCommandObject($command_text)
     {
@@ -129,7 +129,7 @@ class TestHelpers
      *
      * @param array $data Pass custom data array if needed
      *
-     * @return \Longman\TelegramBot\Entities\User
+     * @return User
      */
     public static function getFakeUserObject(array $data = [])
     {
@@ -143,7 +143,7 @@ class TestHelpers
      *
      * @param array $data Pass custom data array if needed
      *
-     * @return \Longman\TelegramBot\Entities\Chat
+     * @return Chat
      */
     public static function getFakeChatObject(array $data = [])
     {
@@ -179,7 +179,7 @@ class TestHelpers
      * @param array $user_data    Pass custom user data array if needed
      * @param array $chat_data    Pass custom chat data array if needed
      *
-     * @return \Longman\TelegramBot\Entities\Message
+     * @return Message
      */
     public static function getFakeMessageObject(array $message_data = [], array $user_data = [], array $chat_data = [])
     {
@@ -223,7 +223,7 @@ class TestHelpers
     /**
      * Empty all tables for the passed database
      *
-     * @param  array $credentials
+     * @param array $credentials
      */
     public static function emptyDb(array $credentials)
     {

utils/importFromLog.php

 <?php
 require __DIR__ . '/../vendor/autoload.php';
 
-$filename='logfile.log';
-$API_KEY = 'random'; 
+$filename = 'logfile.log';
+$API_KEY  = 'random';
 $BOT_NAME = 'bot_name';
-                                                                                                                                                                                                                     
+
 define('PHPUNIT_TESTSUITE', 'some value');
 
-$CREDENTIALS = array('host'=>'localhost', 'user'=>'', 'password'=>'', 'database'=>'');
+$CREDENTIALS = ['host' => 'localhost', 'user' => '', 'password' => '', 'database' => ''];
 
 $update = null;
 try {