Version 0.63.1

Notes

• 📒 View file changes
• This fixed version is necessary for Windows users.

Fixed

• Regex in getFileNamespace() that introduced a breaking bug in #1114. (@jacklul) (#1115)
• Fixed runCommands() not working due to custom namespace feature. (@jacklul) (#1115, #1118)

Version 0.63.0

Notes

• 📒 View file changes ∙ 📃 DB migration script

Added

• New method setUpdateFilter($callback) used to filter processUpdate(Update $update) calls. If $callback returns false the update isn't processed and an empty falsey ServerResponse is returned. (@VRciF) (#1045)
• Replaced 'generic' and 'genericmessage' strings with Telegram::GENERIC_COMMAND and Telegram::GENERIC_MESSAGE_COMMAND constants. (@1int) (#1074)
• Bot API 4.8 (Extra Poll and Dice features). (#1082)
• Allow custom MySQL port to be defined for tests. (#1090)
• New static method Entity::escapeMarkdownV2 for MarkdownV2. (#1094)
• Remove bot token from debug http logs, this can be disabled by setting TelegramLog::$remove_bot_token parameter to false. (@jacklul) (#1095)
• TelegramLog::$always_log_request_and_response parameter to force output of the request and response data to the debug log, also for successful requests. (#1089)
• Bot API 4.9 (New via_bot field). (#1112)

Changed

• ❗ Made Entity::escapeMarkdown static, to not require an Entity object. (#1094)
• Allow custom namespacing for commands. (@Jonybang) (#689)

Fixed

• Primary key for poll_answer also requires the user_id. (#1087)
• Small SQL foreign key fixes. (#1105)

Version 0.62.0

Notes

• 📒 View file changes ∙ 📃 DB migration script

Added

• Bot API 4.5 (Unique file IDs, MarkdownV2). (#1046)
• Chain the exception thrown when getting commands from path. (#1030)
• Support language_code in DB::selectChats() for filtering the chats selection. (#1058)
• Bot API 4.6 (Polls 2.0). (#1066)
• Bot API 4.7 (Dice, Sticker Sets, Bot Commands). (#1067)

Changed

• Save notes an unescaped JSON, to allow easy DB reading and editing of values. (#1005)
• Request::setClient() now accepts more flexible ClientInterface. (#1068)

Removed

• Unnecessary instanceof checks for entities. (#1068)
• Unused Request::$input variable. (#1068)

Fixed

• Execution of /start command without any custom implementation.
• Return animation type for GIF Message (which returns both animation and document). (#1044)
• Change lowercase function to mb_strtolower from strtolower because of latin-extented characters. (#1051)
• Extend Request::mediaInputHelper() to include thumb parameter. (#1059)
• Various docblock annotations. (#1068)

0.61.1

Notes

• 📒 View file changes

Added

• Tests for schema update scripts, to ensure that updates work as expected. (#1025)

Fixed

• Parameter inline_query_id in InlineQuery::answerInlineQuery. (#1021)
• Corrected DB schema update 0.60.0-0.61.0. (#1025)

0.61.0

Notes

• 📒 View file changes ∙ 📃 DB migration script
• ❗ Built-in logging (Monolog) has been removed, a custom PSR-3 logger must be used now! (see #964 for more info)

Added

• Code snippet in GenericmessageCommand to keep obsolete service message system commands working. (#999)
• Static boolean property SystemCommand::$execute_deprecated (must be assigned before handling the request) to try and execute any deprecated system command. (#999)
• Improved MySQL DB index for message table, making the cleanup much faster on bigger databases. (Thanks to @damianperez) (#1015)
• /cleanup command now supports dry run which simply outputs all queries that would be run. (#1015)

Changed

• Small readme and code fixes / simplifications. (#1001)
• Upgrade PHPUnit to 8.x and PHPCS to 3.5. For tests now minimum PHP version is 7.2. (#1008)
• Updated updates log importer (requires PHP7+). (#1009)

Removed

• Service message system commands, which are now handled by GenericmessageCommand. (#999)
• ❗ Monolog has been removed as built-in logging engine. (#1009)
• Assets have been moved to a dedicated repository. (#1012)

Fixed

• Boolean value for Polls gets saved correctly in MySQL DB. (#996)
• Correctly use Request::answerInlineQuery in InlineQuery::answer. (#1001)
• PSR-12 incompatibilities in the codebase. (#1008)
• Improved and corrected /cleanup command. (#1015)

0.60.0

Notes

• 📒 View file changes

Added

• Bot API 4.4 (Animated stickers, ChatPermissions). (#990)

Changed

• Allow passing native entity objects to requests. (#991)

Fixed

• Non-existing commands now correctly execute GenericCommand again. (#993)

0.59.1

Notes

• 📒 View file changes
• ❗ Deprecated logging method will be removed in the next version, update to PSR-3 now! (see #964 for more info)

Added

• Issue labels set automatically via templates.

Changed

• Logging only updates or only debug/errors is now possible. (#983)

Fixed

• Don't output deprecation notices if no logging is enabled. (#983)
• Respect custom HTTP Client initialisation, no matter when it is set. (#986)

0.59.0

Notes

• 📒 View file changes

Changed

• Touched up readme including header and badges. (#981)
• Updated changelog to be more useful for external integrations like Tidelift and GitHub releases. (#981)

Removed

• Abstract methods from InputMedia interface, as method annotations didn't work for propagation. (#978)

0.58.0

Notes

• 📒 View file changes ∙ 📃 DB migration script
• Logging now uses PSR-3 LoggerInterface. Learn more about how to use it here: #964

Added

• New funding and support details. (#971)
• Custom issue templates. (#972)
• Bot API 4.3 (Seamless Telegram Login, LoginUrl) (#957)
• reply_markup field to Message entity. (#957)

Changed

• Use PSR-12 for code style. (#966)
• Some general housekeeping. (#972)
• ❗ 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. (#964)

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. (#964)
• ❗ StartCommand is now a UserCommand (not SystemCommand any more). (#970)

Removed

• Botan.io integration completely removed. (#968)

Fixed

• forward_date is now correctly saved to the DB. (#967)
• Broken StickerSet::getStickers() method. (#969)
• Smaller code and docblock fixes. (#973)

Security

• Security disclosure managed by Tidelift. (#971)
• Don't allow a user to call system commands directly. (#970)

0.57.0

Notes

• 📒 View file changes ∙ 📃 DB migration script
• ❕ This is a big update and involves a bunch of MySQL database updates, so please review the changelog carefully.

Added

• New logo! 🎉 (#954)
• Bot API 4.2 (Polls). (#948)
• getIsMember() method to ChatMember entity. (#948)
• getForwardSenderName() method to Message entity. (#948)
• forward_sender_name (and forgotten forward_signature) DB fields. (#948)
• Added missing API fields to Entities and DB. (#885)
• Created database tables for shipping_query and pre_checkout_query. (#885)

Fixed

• Missing DB table name specifier in /cleanup command. (#947)