Discord

Discord is the main object of your Discord BOT Application

Methods

__construct()

Creates a Discord Bot client instance.

function __construct([array<string|int, mixed> $options = [] ]) : mixed

Return

• Discord the Bot client object

Example

$discord = new Discord([
    'token' => 'bot-token',
]);

close()

Closes the Discord Bot client.

function close([bool $closeLoop = true ]) : void

Example

$discord->close();

factory()

Creates a Part or Repository inside the Bot client.

function factory(string $class[, mixed $data = [] ][, bool $created = false ]) : Part|AbstractRepository

The use of factory with part is possible with the new Part($discord, $data, $created);

Return

• Part or AbstractRepository

Example

// Preferred way
$channel = new Channel($discord, ['name' => 'newchannel']);
// Is equivalent to:
$channel = $discord->factory(Channel::class, ['name' => 'newchannel']);

getChannel()

Gets a channel from the Bot cache by Snowflake ID.

function getChannel(string|int $channel_id) : Channel|null

Return

• Channel the Channel, Thread, or Private Channel Part

Example

$channel = $discord->getChannel('012345678910111213');

getFactory()

Gets the factory being used by the Bot client.

function getFactory() : Factory

Return

• Factory the Factory object

Example

$factory = $discord->getFactory();

getHttpClient()

Gets the Discord HTTP client being used by the Bot client.

function getHttpClient() : Http

Return

• Http the DiscordPHP Http object

Example

$httpClient = $discord->getHttpClient();

getLogger()

Gets the PSR-3 logger being used by the Bot client.

function getLogger() : LoggerInterface

Return

• LoggerInterface the Logger interface

Example

$logger = $discord->getLogger();

getLoop()

Gets the ReactPHP event loop loop being used by the Bot client.

function getLoop() : LoopInterface

Return

• LoopInterface Loop interface

Example

$loop = $discord->getLoop();

getVoiceClient()

Gets the bot voice client from a guild ID. Returns null if there is no voice client.

function getVoiceClient(string $guild_id) : VoiceClient|null

Return

• VoiceClient the bot Voice Client
• null the bot has no Voice Client

Example

$voiceClient = $discord->getVoiceClient('012345678910111213');

joinVoiceChannel()

Joins a voice channel.

function joinVoiceChannel(Channel $channel[, bool $mute = false ][, bool $deaf = true ][, LoggerInterface|null $logger = null ][, bool $check = true ]) : PromiseInterface

Return

• PromiseInterface the promise when Bot has joined the voice channel

Example

$channel = $discord->getChannel('0123456789'); // Get the voice channel by ID

$discord->joinVoiceChannel($channel)->done(function (VoiceClient $vc) {
    echo "Joined voice channel.\r\n";
    $vc->playFile('myaudio.mp3');
}, function ($e) {
    echo "There was an error joining the voice channel: {$e->getMessage()}\r\n"; 
});

run()

Run the Bot client, starts the ReactPHP event loop.

function run() : void

Example

// Should be placed at bottom of the script
$discord->run();

updatePresence()

Updates the Bot client's presence and status.

function updatePresence([Activity|null $activity = null ][, bool $idle = false ][, string $status = 'online' ][, bool $afk = false ]) : void

See Activity

API Documentation: https://discord.com/developers/docs/topics/gateway#update-presence

Example

$activity = new Activity($discord, [
    'name' => 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
    'type' => Activity::TYPE_WATCHING
]);

$discord->updatePresence($activity);

Events

To handle various events from Discord, you can use $discord->on(string EVENTNAME, callable CALLBACK);

ready

Unlike "READY", this event is emitted once when the Discord BOT is ready (e.g. after start-up tasks like loadAllMembers is done).

Gateway event listeners should be registered inside this event.

Example

$discord->on('ready', function ($discord) {
    echo "Bot is ready.", PHP_EOL;
});

reconnected

This event is called when the Bot client's web socket has successfully reconnected to Discord server.

Example

$discord->on('reconnected', function ($discord) {
    echo "Bot is reconnected.", PHP_EOL;
});

closed

This event is called when $discord->close() is called.

Example

$discord->on('closed', function ($discord) {
    // do something, e.g. clean up
});

raw

This is only for advanced users.

This event is called when any enabled events from gateway is dispatched from the Bot client's web socket containing the raw data, before the respective Repository and Part is formed.

Example

$discord->on('raw', function ($data, $discord) {
    // $data contains the payload after json_decode()
});

error

This is only for advanced users.

This event is called the Bot client's web socket error occurred. The web socket connection is immediately closed so you cannot interrupt this event.

Example

$discord->on('error', function ($error, $discord) {
    // do something e.g. log the error or do clean up
});