discord php — это библиотека PHP, разработанная для включения и упрощения создания и соединения между веб-сайтами, онлайн-приложениями и Discord.
Требуется только PHP 5.6+. Давайте начнем загружать библиотеку discord-php, а затем распакуем ее в your_server_path/
.
Быстрый способ — импортировать Autoload.php
:
require_once ( " /your/custom/path/to/discord-php/Autoload.php " );
Кроме того, вы можете включить только необходимые классы:
// Required
require_once ( " ./Discord.php " );
require_once ( " ./Client.php " );
// Optional
include_once ( " ./Discord/Guilds.php " );
include_once ( " ./Discord/Channels.php " );
Прежде чем использовать discord php lib , вы должны создать приложение Discord, а затем создать «Новый объект конфигурации». следующим образом:
$ 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 );
Где:
client_id
= @me
— Требуется для запросов oAuth2 / Token Exchange ;;client_secret
= Требуется для запросов oAuth2 / Token Exchange ;token
= Требуется для любого запроса API , например New DiscordClientUsers("USER_ID");
; Также вы можете легко добавить всю информацию о своем приложении Discord, используя файл ./Configs.php
, включая следующее:
$ discord_configs = New Discord Configs ( include ( " ./Configs.php " ));
Создайте клиент Discord на основе ваших конфигураций Discord, чтобы отправлять запросы Discord API следующим образом:
$discord = New DiscordClient($discord_configs);
Теперь вы готовы использовать библиотеку discord php по своему усмотрению! Все, что вам нужно знать о библиотеке, например, о классах и «Как использовать», описано здесь, в Wiki. Я надеюсь, что эта библиотека поможет вам писать код для Discord на PHP. Любые предложения или улучшения всегда приветствуются.
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
Прежде чем начать, вам необходимо узнать больше об объекте «Схрон». Прежде всего, схрон — это необязательный массив, который можно настроить во время создания новой конфигурации Discord. Соблюдая стандарт, предложенный в примере, вы можете легко использовать «Клиент Discord» для отправки ответов API следующим образом:
$ 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 " );