Merge pull request #551 from noplanman/bot_api_3.1

Bot API 3.1

CHANGELOG.md

@@ -6,7 +6,9 @@ Exclamation symbols (:exclamation:) note something of importance e.g. breaking c
 ## [Unreleased]
 ### Added
 - Callbacks can be added to be executed when callback queries are called.
+- New Bot API 3.1 changes (#550).
 ### Changed
+- [:exclamation:][unreleased-bc-request-class-refactor] Big refactor of the `Request` class, removing most custom method implementations.
 ### Deprecated
 ### Removed
 ### Fixed
@@ -122,6 +124,7 @@ Exclamation symbols (:exclamation:) note something of importance e.g. breaking c
 ### Deprecated
 - Move `hideKeyboard` to `removeKeyboard`.
 
+[unreleased-bc-request-class-refactor]: https://github.com/php-telegram-bot/core/wiki/Breaking-backwards-compatibility#request-class-refactor
 [0.45.0-bc-remove-deprecated-methods]: https://github.com/php-telegram-bot/core/wiki/Breaking-backwards-compatibility#remove-deprecated-methods
 [0.45.0-bc-chats-params-array]: https://github.com/php-telegram-bot/core/wiki/Breaking-backwards-compatibility#chats-params-array
 [0.45.0-bc-up-download-directory]: https://github.com/php-telegram-bot/core/wiki/Breaking-backwards-compatibility#up-download-directory

src/Entities/Chat.php

@@ -15,23 +15,39 @@ namespace Longman\TelegramBot\Entities;
  *
  * @link https://core.telegram.org/bots/api#chat
  *
- * @property int    $id                              Unique identifier for this chat. This number may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier.
- * @property string $type                            Type of chat, can be either "private", "group", "supergroup" or "channel"
- * @property string $title                           Optional. Title, for channels and group chats
- * @property string $username                        Optional. Username, for private chats, supergroups and channels if available
- * @property string $first_name                      Optional. First name of the other party in a private chat
- * @property string $last_name                       Optional. Last name of the other party in a private chat
- * @property bool   $all_members_are_administrators  Optional. True if a group has ‘All Members Are Admins’ enabled.
- * @method   int    getId()                          Unique identifier for this chat. This number may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier.
- * @method   string getType()                        Type of chat, can be either "private ", "group", "supergroup" or "channel"
- * @method   string getTitle()                       Optional. Title, for channels and group chats
- * @method   string getUsername()                    Optional. Username, for private chats, supergroups and channels if available
- * @method   string getFirstName()                   Optional. First name of the other party in a private chat
- * @method   string getLastName()                    Optional. Last name of the other party in a private chat
- * @method   bool   getAllMembersAreAdministrators() Optional. True if a group has ‘All Members Are Admins’ enabled.
+ * @property int       $id                              Unique identifier for this chat. This number may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier.
+ * @property string    $type                            Type of chat, can be either "private", "group", "supergroup" or "channel"
+ * @property string    $title                           Optional. Title, for channels and group chats
+ * @property string    $username                        Optional. Username, for private chats, supergroups and channels if available
+ * @property string    $first_name                      Optional. First name of the other party in a private chat
+ * @property string    $last_name                       Optional. Last name of the other party in a private chat
+ * @property bool      $all_members_are_administrators  Optional. True if a group has ‘All Members Are Admins’ enabled.
+ * @property ChatPhoto $photo                           Optional. Chat photo. Returned only in getChat.
+ * @property string    $description                     Optional. Description, for supergroups and channel chats. Returned only in getChat.
+ * @property string    $invite_link                     Optional. Chat invite link, for supergroups and channel chats. Returned only in getChat.
+ * @method   int       getId()                          Unique identifier for this chat. This number may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier.
+ * @method   string    getType()                        Type of chat, can be either "private ", "group", "supergroup" or "channel"
+ * @method   string    getTitle()                       Optional. Title, for channels and group chats
+ * @method   string    getUsername()                    Optional. Username, for private chats, supergroups and channels if available
+ * @method   string    getFirstName()                   Optional. First name of the other party in a private chat
+ * @method   string    getLastName()                    Optional. Last name of the other party in a private chat
+ * @method   bool      getAllMembersAreAdministrators() Optional. True if a group has ‘All Members Are Admins’ enabled.
+ * @method   ChatPhoto getPhoto()                       Optional. Chat photo. Returned only in getChat.
+ * @method   string    getDescription()                 Optional. Description, for supergroups and channel chats. Returned only in getChat.
+ * @method   string    getInviteLink()                  Optional. Chat invite link, for supergroups and channel chats. Returned only in getChat.
  */
 class Chat extends Entity
 {
+    /**
+     * {@inheritdoc}
+     */
+    public function subEntities()
+    {
+        return [
+            'photo' => ChatPhoto::class,
+        ];
+    }
+
     public function __construct($data)
     {
         parent::__construct($data);

src/Entities/ChatMember.php

@@ -15,8 +15,22 @@ namespace Longman\TelegramBot\Entities;
  *
  * @link https://core.telegram.org/bots/api#chatmember
  *
- * @method User   getUser()   Information about the user.
- * @method string getStatus() The member's status in the chat. Can be "creator", "administrator", "member", "left" or "kicked"
+ * @method User   getUser()                  Information about the user
+ * @method string getStatus()                The member's status in the chat. Can be “creator”, “administrator”, “member”, “restricted”, “left” or “kicked”
+ * @method int    getUntilDate()             Optional. Restricted and kicked only. Date when restrictions will be lifted for this user, unix time
+ * @method bool   getCanBeEdited()           Optional. Administrators only. True, if the bot is allowed to edit administrator privileges of that user
+ * @method bool   getCanChangeInfo()         Optional. Administrators only. True, if the administrator can change the chat title, photo and other settings
+ * @method bool   getCanPostMessages()       Optional. Administrators only. True, if the administrator can post in the channel, channels only
+ * @method bool   getCanEditMessages()       Optional. Administrators only. True, if the administrator can edit messages of other users, channels only
+ * @method bool   getCanDeleteMessages()     Optional. Administrators only. True, if the administrator can delete messages of other users
+ * @method bool   getCanInviteUsers()        Optional. Administrators only. True, if the administrator can invite new users to the chat
+ * @method bool   getCanRestrictMembers()    Optional. Administrators only. True, if the administrator can restrict, ban or unban chat members
+ * @method bool   getCanPinMessages()        Optional. Administrators only. True, if the administrator can pin messages, supergroups only
+ * @method bool   getCanPromoteMembers()     Optional. Administrators only. True, if the administrator can add new administrators with a subset of his own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by the user)
+ * @method bool   getCanSendMessages()       Optional. Restricted only. True, if the user can send text messages, contacts, locations and venues
+ * @method bool   getCanSendMediaMessages()  Optional. Restricted only. True, if the user can send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages
+ * @method bool   getCanSendOtherMessages()  Optional. Restricted only. True, if the user can send animations, games, stickers and use inline bots, implies can_send_media_messages
+ * @method bool   getCanAddWebPagePreviews() Optional. Restricted only. True, if user may add web page previews to his messages, implies can_send_media_messages
  */
 class ChatMember extends Entity
 {

src/Entities/ChatPhoto.php

+<?php
+/**
+ * This file is part of the TelegramBot package.
+ *
+ * (c) Avtandil Kikabidze aka LONGMAN <akalongman@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Longman\TelegramBot\Entities;
+
+/**
+ * Class ChatPhoto
+ *
+ * @link https://core.telegram.org/bots/api#chatphoto
+ *
+ * @method string getSmallFileId() Unique file identifier of small(160x160) chat photo. This file_id can be used only for photo download.
+ * @method string getBigFileId()   Unique file identifier of big(640x640) chat photo. This file_id can be used only for photo download.
+ */
+class ChatPhoto extends Entity
+{
+
+}

src/Telegram.php

@@ -787,7 +787,19 @@ class Telegram
             throw new TelegramException('Hook url is empty!');
         }
 
-        $result = Request::setWebhook($url, $data);
+        $data        = array_intersect_key($data, array_flip([
+            'certificate',
+            'max_connections',
+            'allowed_updates',
+        ]));
+        $data['url'] = $url;
+
+        // If the certificate is passed as a path, encode and add the file to the data array.
+        if (!empty($data['certificate']) && is_string($data['certificate'])) {
+            $data['certificate'] = Request::encodeFile($data['certificate']);
+        }
+
+        $result = Request::setWebhook($data);
 
         if (!$result->isOk()) {
             throw new TelegramException(