discord php é uma biblioteca PHP desenvolvida para incluir e simplificar a criação e conexão entre sites, aplicativos online e Discord.
Apenas PHP 5.6+ é necessário. Vamos começar a baixar a biblioteca discord-php e extraí-la para your_server_path/
.
Uma maneira rápida é importar o Autoload.php
:
require_once ( " /your/custom/path/to/discord-php/Autoload.php " );
Além disso, você pode incluir apenas as classes necessárias:
// Required
require_once ( " ./Discord.php " );
require_once ( " ./Client.php " );
// Optional
include_once ( " ./Discord/Guilds.php " );
include_once ( " ./Discord/Channels.php " );
Antes de usar o discord php lib , você deve criar seu aplicativo Discord e, em seguida, criar um "Novo objeto de configuração". como segue:
$ configs = array ();
$ configs [ " token " ] = " YOUR_BOT_TOKEN " ;
$ configs [ " authType " ] = " Bot " ; // Optional (Default: "Bot")
$ configs [ " client_id " ] = " YOUR_CLIENT_ID " ; // Optional (Default: null)
$ configs [ " client_secret " ] = " YOUR_CLIENT_SECRET " ; // Optional (Default: null)
$ configs [ " public_key " ] = " YOUR_PUBLIC_KEY " ; // Optional (Default: null)
$ configs [ " stash " ] = array ( // Optional
" Guild Name " => array (
" guild_id " => " YOUR_SERVER_ID " ,
" channels " => array (
" Channel Name " => " YOUR_CHANNEL_ID "
),
" roles " => array (
" Role Name " => " YOUR_ROLE_ID "
),
" members " => array (
" Member Name " => " YOUR_MEMBER_USER_ID "
)
)
);
$ discord_configs = New Discord Configs ( $ configs );
Onde:
client_id
= @me
- Obrigatório para solicitações oAuth2 / Token Exchange ;;client_secret
=Obrigatório para solicitações oAuth2 / Token Exchange ;token
= Obrigatório para qualquer solicitação de API , como New DiscordClientUsers("USER_ID");
; Além disso, você pode adicionar facilmente todas as informações do seu aplicativo Discord usando o arquivo ./Configs.php
e incluindo o seguinte:
$ discord_configs = New Discord Configs ( include ( " ./Configs.php " ));
Crie um cliente Discord com base em suas configurações do Discord, para enviar solicitações da API Discord da seguinte forma:
$discord = New DiscordClient($discord_configs);
Agora você está pronto para usar o discord php lib como desejar! Tudo o que você precisa saber sobre a biblioteca, como Aulas e “Como Usar”, está descrito aqui no Wiki. Espero que esta biblioteca ajude você a codificar para Discord em PHP. Qualquer sugestão ou melhoria é sempre bem vinda.
require_once ( " ./Autoload.php " );
$ configs = include ( " ./Configs.php " );
$ discord = New Discord Client ( New Discord Configs ( $ configs ));
// Guilds
$ guild = New Discord Client Guilds ( $ discord , " GUILD_ID " );
$ members = $ guild -> members ();
$ specific_member = $ guild -> members ( " USER_ID " ); // Will return a DiscordClientMembers Object
$ channels = $ guild -> channels ();
$ specific_channel = $ guild -> channels ( " CHANNEL_ID " ); // Will return a DiscordClientChannels Object
// Channels
$ channel = New Discord Client Channels ( $ discord , " CHANNEL_ID " );
$ messages = $ channel -> messages ();
$ specific_message = $ channel -> message ( " MESSAGE_ID " ); // Will return a DiscordClientMessages Object
$discord->stash
Antes de começar, você precisa aprender mais sobre um objeto “Stash”: Primeiro de tudo, um stash é um array opcional para configurar durante a criação de uma nova configuração do Discord. Respeitando o padrão proposto no exemplo, você pode facilmente utilizar o “Discord Client” para realizar respostas da API, conforme a seguir:
$ configs = array (
" token " => " YOUR_BOT_TOKEN " ,
" stash " => array (
" CUSTOM_GUILD_NAME " => array (
" guild_id " => " YOUR_GUILD_ID "
"channels" => array (
" CUSTOM_CHANNEL_NAME " => " YOUR_CHANNEL_ID "
)
),
" CUSTOM_GUILD_NAME_2 " => array (
" channels " => array (
" CUSTOM_CHANNEL_NAME_2 " => " YOUR_CHANNEL_ID_2 "
)
)
)
);
$ discord = New Discord Client ( New Discord Configs ( $ configs ));
// Get a DiscordClientGuilds directly from the client using your Stash
// Please, make sure you've correctly imported ./Discord/Guilds.php class before.
// Also, make sure you're using the right $config standard and "GUILD_NAME" in order to get automatically a GUILD_ID
$ guild = $ discord -> Guilds ( " CUSTOM_GUILD_NAME " );
// You can also send a custom Guild ID
$ guild = $ discord -> Guilds ( " GUILD_ID " );
// You can do the same for the channels
// Make sure you've correctly imported ./Discord/Channels.php class before
$ channel = $ discord -> Channels ( " CUSTOM_CHANNEL_NAME_2 " );
// And then, to get a channel using a custom Channel ID
$ channel = $ discord -> Channels ( " CHANNEL_ID " );