Add support for Message Thread ID (Topics)

[Niklan]

This PR adds optional support for sending messages to specific group threads. This is a feature of group chats with the Topics feature enabled.

Parameter	Type	Required	Description
message_thread_id	Integer	Optional	Unique identifier for the target message thread (topic) of the forum; for forum supergroups only

https://core.telegram.org/bots/api#sendmessage

For backward compatibility, it is added as a last parameter.

[jacklul]

Looks good but please fix the error code sniffer is whining about

[Niklan]

Also, it looks like a mistake in \jacklul\MonologTelegramHandler\TelegramHandler::__construct

it says:

@param Level     $level           The minimum logging level at which this handler will be triggered

but actually it can handle not just \Monolog\Level but also int and string: int|string|Level $level = Level::Debug.

This can be a problem with PHPStan or any other static code analyzer, which prioritizes, in most cases, document block parameter definitions over actual type hints. Looks like it should be improved to:

@param int|string|Level $level    The minimum logging level at which this handler will be triggered

If it should be fixed, then it should be done as a separate pull request or we can fix it here?

If you agree that this should be fixed, what a proper formatting (alignment) should be in that case?

Variant №1:

    /**
     * @param string    $token           Telegram bot API token
     * @param int       $chatId          Chat ID to which logs will be sent
     * @param int|string|Level $level    The minimum logging level at which this handler will be triggered
     * @param bool      $bubble          Whether the messages that are handled can bubble up the stack or not
     * @param bool      $useCurl         Whether to use cURL extension when available or not
     * @param int       $timeout         Maximum time to wait for requests to finish
     * @param bool      $verifyPeer      Whether to use SSL certificate verification or not
     * @param int|null  $messageThreadId Thread ID for group chats with Topics feature enabled
     */

Variant №2:

    /**
     * @param string           $token           Telegram bot API token
     * @param int              $chatId          Chat ID to which logs will be sent
     * @param int|string|Level $level           The minimum logging level at which this handler will be triggered
     * @param bool             $bubble          Whether the messages that are handled can bubble up the stack or not
     * @param bool             $useCurl         Whether to use cURL extension when available or not
     * @param int              $timeout         Maximum time to wait for requests to finish
     * @param bool             $verifyPeer      Whether to use SSL certificate verification or not
     * @param int|null         $messageThreadId Thread ID for group chats with Topics feature enabled
     */

Both variants passes composer check-code, so it is unclear what is intended formatting.

[jacklul]

I don't mind fixing it in this PR, the second variant is more readable

[Niklan]

Synced with the master and added a second variant of the docblock to \jacklul\MonologTelegramHandler\TelegramHandler::__construct.

[jacklul]

Thanks!