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 lib كما يحلو لك! كل ما تحتاج لمعرفته حول المكتبة، مثل الفصول الدراسية و"كيفية الاستخدام"، موصوف هنا في 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 Client" لإجراء استجابات 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 " );