Version 5.2.0 Release Candidate 1

• PHP 7.4 is now the lowest supported version of PHP.
  • Versions as low as PHP 7.2 may still work, however, no support will be provided.
• Discord Gateway and REST API versions changed to Version 8.
• Removed unnecessary deferred promises from various parts and repositories.
• Message::reply() now creates a "Discord reply" rather than the old way which was simply a mention with the content afterwards.
• Tidied up and removed any unessacary deferred promises and promise binds.

HTTP Client

• HTTP client has been moved to a seperate package: DiscordPHP-Http
• Improved rate limits by grouping requests by major parameters.

Voice Client

• The following functions no longer return promises, rather they throw exceptions and will return void. This is because none of these functions actually did any async work, therefore promises were redundant in this situation.
  • setSpeaking()
  • switchChannel()
  • setFrameSize()
  • setBitrate()
  • setVolume()
  • setAudioApplication()
  • setMuteDeaf()
  • pause()
  • unpause()
  • stop()
  • close()
  • getRecieveStream()
• Although this is not deemed a breaking change it will break anything that uses the promise response.
• Expect a voice client refactor in a future release.

Version 5.1.1

• Added permission checking before executing requests for channels.
• Fixed issue where global rate limits would delay too long.
• Added option to pass through react/socket connector options through socket_options.
• Fixed issue with case-insensitive commands in the command client.
• Fixed issue where users would not update in the user repository on an GUILD_MEMBER_* event.
• Repository is now hosted under the discord-php organisation on GitHub. This will not change anything unless you have the repository cloned.
• Fixed an issue where guild repositories would empty on GUILD_UPDATE.
• Fixed issue where buckets would deadlock when there is a global rate limit and a non-global rate limit at the same time.
• Token is now stripped from any text output.
• TYPE_STREAMING and TYPE_COMPETING is now allowed for bots.
• Fixed an issue where a bucket queue would be blocked when a request throws an exception.

Version 5.1.0

• Refactored and rebuilt the HTTP client.
  • Implemented the concept of "buckets" - to be worked on as at the moment requests are grouped by the exact endpoint only.
• Fixed guild member chunking with the gateway changes.
• Fixed Channel::deleteMessages() not working for 0 or 1 messages.
• Added the allowed_mentions option to Channel::sendMessage().
• Converted message reactions to a repository.
• Changed Message::mention_channels to use a regular expression to find actual mentioned channels rather than relying on Discord to send them (which they don't).
• Fixed varius errors where the attribute does not exist.
• Added the Reaction::getUsers() method to retrieve users that have reacted with that reaction.
• Implemented audit logs - see the class reference and Discord developer docs for more information.
• Added new attributes to Guilds.
• Fixed permissions not calculating correctly.
• Fixed various errors with the voice client.
• Added an option to skip FFmpeg/DCA checks when starting the voice client (for Windows compatibility).
• Implemented MESSAGE_REACTION_* events.
• Added \Discord\imageToBase64() to convert an image to base 64 to be uploaded to Discord.
• Started documentation and tests.

Command Client

• Added the caseInsensitiveCommands option to change whether commands should be case sensitive.
• Added sub-commands to the various help menus.

Version 5.0.12

• Converted PromiseInterface to ExtendedPromiseInterface to allow ->done() typehinting.
• Converted most ->then() to ->done() for better error handling.
• Fixed issue with member chunking not working correctly due to changes in Discord's gateway.
• Implemented gateway payload rate-limiting.
• Removed illuminate/support dependency.
• Fixed errors in HTTP going into the response handler function and causing errors.
• Added Channel::limitDelete(n) to delete the last n messages.
• Added setter functions to embeds. Now much easier to set, and more reliable.
• Added $guild->leave() as a shortcut to $discord->guilds->leave($guild).
• Parts are now constructable without factory:

Old:

$message = $discord->factory(Message::class);

New:

$message = new Message($message);

Both methods are still valid.

• AbstractRepository now extends Collection rather than having magic functions to handle calls.
• Added WebhookRepository::get().
• Added support functions:
  • getColor(int $color);
  • contains(string $key, array $matches);
  • studly(string $string)
  • poly_strlen(string $string)

Version 5.0.11

• Added dependabot to update composer dependencies.
• Upgraded react/partial to ^3.0.
• Discord will now emit reconnected when the client reconnects via identify OR resume.
• Fixed issue with resumes not working due to closing with opcode 1000.
• Client will now attempt to resume after an invalid session if it is still resumable.
• Exceptions inside the ready handler will now be caught, emitted via exception and logged.
  • Temporary fix until react/promise ^3.0 is released, as any uncaught exceptions inside promises are dismissed.
• Added Discord::getChannel(id) which searches through all guilds and private channels to find a channel.
• Channel::deleteMessages() now works for private channels by looping through all messages and deleting.
• Added Channel::editMessage().
• Added new activity types Activity::TYPE_WATCHING and Activity::TYPE_COMPETING.
• Fixed issue with MESSAGE_DELETE events not working correctly.
• Fixed issie with VOICE_STATE_UPDATE where members were not removed from their old channels.

Version 5.0.10

• The PHP composer dependency has been updated to PHP 7.2. The library was not working on anything less in previous versions so I'm not deeming this a breaking change, just a formality.
• Added PHP 7.2 typehinting to functions.
• Added Collection::first() to get the first element of the collection.
• Added the ability to call AbstractRepository::delete() with a string ID instead of solely a part.
• Any custom logger now may be passed to the Discord client as long as it implementes LoggerInterface from PSR.
• Fixed phpdocs for collections, typehinting will now work when accessing it as an array.
• Fixed bug with Collection::get() when not searching by discriminator.
• Added Webhook::execute().
• Added support for illuminate/support 8.0.
• Channel::deleteMessages() will no longer fail if 0 or 1 messages is given. The promise will instantly resolve when given 0, and will delete the one message then resolve for 1 message.
• Fixed error when handling message deletes.
• Websocket will no longer close when an error is seen, as Pawl's errors do not always cause closure of the websocket.
• Fixed bug with rate limiting after changing to react/http.
• Fixed bug with sending files after changing to react/http.

Version 5.0.3

• Development of the library will now continue on the master branch. The develop branch will be removed and you should checkout the latest tag for the most stable version.
• Removed dependency of decepreated package wyrihaximus/react-guzzle-psr7, replaced with react/http.
  • Rewrote HTTP client to remove dependency of Guzzle.
• Client will prevent updating presence with an invalid activity type.
• Collections:
  • Added Collection::set($offset, $value).
  • Added Collection::isset($offset).
• Added Message::sendEmbed(Embed $embed) as a shortcut to sending embeds.
• Fixed an issue on Windows where emoticons were not URL encoded.
• Added Embed::addField(Field $field) to add fields to an embed.
• Added user activity statuses constants to Activity.
• Member::addRole(Role $role) and Member::removeRole(Role $role) now modifies the member on Discord's end.
  • You no longer need to run $guild->members->save($member).
  • The function now returns a promise.
• Added Member::getPermissions(Channel? $channel) to get the total permissions of the member for a guild or channel.
• The avatar attribute of a user will return their default avatar when it is null.

Version 5.0.2

• Fixed updating and creating parts.
• Fixed repository saving.
• Removed debugging statement.
• Removed bind_right statement that was left over.
• Fixed setting overwrites.

Version 5.0.1

• Removed option for bot = false. This option wouldn't have worked anyway so I am not classing it as a breaking change.
• Converted all getter and setter functions in parts to protected. Again, shouldn't be a breaking change as these function aren't meant to be used outside of the library.
• Webhooks:
  • Added phpdoc to webhook part.
  • Added webhook type constants
• Guilds:
  • Added new guild attributes.
• Removed unused attributes cache from part.
• Removed password attribute from Client.
• Added new user attributes and flags.
• Voice client now handles websocket closes better.
• Client will now load online users regardless of loadAllMembers option. This option will now cause the client to initiate guild member chunking offline members.

Version 5.0.0

First release for many years. Contains many bug fixes and stability patches so this is the most important update since.

Breaking Changes

• PHP 7.0 is now required. PHP 5.x is no longer supported. Expect PHP 7.1 to be required in the near future.
• Package versions:
  • illuminate/support: now supports Laravel 6.x and 7.x
  • nesbot/carbon: was ^1.18, now ^2.38
  • symfony/options-resolver: was ^3.0, now ^5.1.3
  • monolog/monolog: was ^1.19, now ^2.1
• Cache adapters such as apc, memcache and redis are no longer supported. There is no longer a cachePool option.
• ext-libevent is no longer supported as it only applies for PHP 5.x.
• The Collection class no longer extends Laravel collections.
  • As such, some functions are no longer present.
  • Feel free to add an issue if you would like to see a function added.
• Channels:
  • Channel::setPermissions() function now takes a role or member as well as two arrays: one array of allow permissions and one array of deny permissions.
  • Channel::createInvite() now takes an array of options. See the Discord developer docs for a list of valid options.
  • Messages can no longer be created using the message repository as part of the channel. Use Channel::sendMessage() instead.
• Overwrites:
  • The allow and deny parameters of an overwrite are an instance of ChannelPermission instead of int.
• Guilds:
  • Removed old region constants. Added the Guild::getVoiceRegions() function to get an array of valid regions.
  • Guild::validateRegion() now has to perform an async HTTP request to validate the region. Only use this if nessasary.
• Removed the Game class. Renamed to Activity and new attributes added.
• Discord::updatePresence() now takes an Activity object as well as options idle, status and afk.

Features

• Added getLoop() and getLogger() functions to the Discord client.
• Collectors:
  • Channels now have message collectors. See the phpdoc of Channel::createMessageColletor() for more information.
  • Messages now have reaction collectors. See the phpdoc of Message::createReactionCollector() for more information.
• Added the Reaction class.
• Added the Webhook class.
• Implemented gateway intents:
  • See the Intents class for constants.
  • User can specify an intents field in the options array, containing either an array of intents or an integer corresponding to the intents.

Changes

• WebSocket:
  • Added new events: GUILD_INTEGRATIONS_UPDATE, INVITE_CREATE, INVITE_DELETE, MESSAGE_REACTION_REMOVE_EMOJI.
  • Client will not retrieve guild bans by default anymore. Set retrieveBans to true in options to retrieve on guild availability.
• Command client:
  • Help command now prints a rich embed (#305 thanks @oliverschloebe)
  • Commands have a short and long description.
  • Commands have a cooldown option.
• Factory now has a part() and repository() function to bypass strpos functions.
• Channels:
  • Added new attributes.
  • Added new channel types.
  • Added webhook classes and repositories.
  • Channel::setOverwrite() has been added to perform the action of setPermissions() from the previous version.
• Messages:
  • Added new attributes.
  • Added new message types.
  • Added Message::delayedReply() to perform a reply after a specified duration.
  • Message::react() and Message::deleteReaction() now takes an Emoji object or a string emoji.
  • Added Message::delete() to delete a message without using the repository.
  • Added Message::addEmbed() to add an embed to the message.
  • Added the MessageReaction class to represent a reaction to a message.
• Embeds:
  • Added the type parameter.
• Emojis:
  • Added the animated parameter.
  • Added the Emoji::toReactionString() function to convert to a format to put in a Reaction object.
  • Added the Emoji::__toString() object for sending emojis in messages.
• Guilds:
  • Guild region is no longer checked before saving. Make sure to handle any exceptions from Discord servers and do not spam.
  • Roles can now update their mentionable attribute.
• Permissions:
  • Added new permissions.
• Members:
  • Added new attributes.
  • The game attribute now returns an Activity part.
• Presence updates:
  • Added new attributes.
• Typing updates:
  • Added new attributes.
• Voice state updates:
  • Added new attributes.

Bug Fixes

• Improved memory usage by removing resolve and reject functions from Parts.
  • Memory leak has been improved but is still preset.
• AbstractRepository::freshen() now actually freshens the part, rather than being cached.
• Voice client has been updated to use the correct UDP server given by the web socket.
• Events should update their corresponding repositories more consistently.
• Improved the processing speed of GUILD_CREATE and GUILD_MEMBERS_CHUNK events.
• Added new gateway operation and close codes.
• Client will not attempt to reconnect to Discord servers if it receives a "critical" opcode (one that cannot be resolved by the bot).