DiscordPHP

DiscordPHP

غلاف لواجهات برمجة تطبيقات Discord REST والبوابة والصوت الرسمية. التوثيق متاح هنا، وإن كان محدودًا في الوقت الحالي، بالإضافة إلى مرجع للفصل الدراسي. لا تتردد في طرح الأسئلة في خادم Discord أعلاه.

للاختبار والاستقرار، سيكون موضع تقدير كبير إذا تمكنت من إضافة روبوت الاختبار الخاص بنا إلى الخادم الخاص بك. نحن لا نقوم بتخزين أي بيانات - فالروبوت ببساطة لا يتفاعل مع أي شخص ويستخدم لاختبار الاستقرار مع أعداد كبيرة من النقابات. يمكنك دعوة الروبوت هنا.

واجهة ذاكرة التخزين المؤقت (تجريبية)

تحذير هذا الفرع يحتوي على خاصية تجريبية، لا تستخدمها في الإنتاج! راجع صفحة wiki لمزيد من المعلومات حول كيفية إعدادها.

التعليمات

1. هل يمكنني تشغيل DiscordPHP على خادم ويب (مثل Apache وnginx)؟

• لا، سيتم تشغيل DiscordPHP فقط في واجهة سطر الأوامر (CLI). إذا كنت ترغب في الحصول على واجهة للروبوت الخاص بك، فيمكنك دمج رد الفعل/http مع الروبوت الخاص بك وتشغيله من خلال واجهة سطر الأوامر (CLI).

2. PHP ينفد من الذاكرة؟

• حاول إلغاء تقييد ذاكرة PHP باستخدام ini_set('memory_limit', '-1'); .

ابدء

قبل البدء في استخدام هذه المكتبة، تحتاج إلى معرفة كيفية عمل PHP، وتحتاج إلى معرفة كيفية عمل حلقات الأحداث والوعود. وهذا مطلب أساسي قبل البدء. وبدون هذه المعرفة، سوف تعاني فقط.

متطلبات

• PHP 8.0 أو أعلى (يوصى بأحدث إصدار)

• يتطلب الإصدار x86 (32 بت) PHP تمكين ext-gmp .

• ext-json

• ext-zlib

الملحقات الموصى بها

• أحد الأحداث ext-uv (مستحسن)، ext-ev ، أو ext-event لحلقة حدث أسرع وأكثر أداءً.

• ext-mbstring في حالة التعامل مع أحرف غير لاتينية.

متطلبات الصوت

• PHP 64 بت

• ext-sodium

• FFmpeg

ويندوز وSSL

لسوء الحظ، PHP على نظام التشغيل Windows لا يستطيع الوصول إلى متجر شهادات Windows. هذه مشكلة لأنه يتم استخدام TLS وبالتالي يتم تطبيق التحقق من الشهادة (إيقاف تشغيل هذا ليس خيارًا).

ستلاحظ هذه المشكلة من خلال خروج البرنامج النصي الخاص بك فورًا بعد تشغيل حلقة واحدة دون أي أخطاء.

نظرًا لأن مستخدمي هذه المكتبة يحتاجون إلى تنزيل مستخلص المرجع المصدق من موقع cURL الإلكتروني.
يجب تعيين المسار إلى caextract في php.ini لملف openssl.cafile .

تثبيت DiscordPHP

يتم تثبيت DiscordPHP باستخدام Composer.

1. composer require team-reflex/discord-php . سيؤدي هذا إلى تثبيت أحدث إصدار مستقر.

• إذا كنت ترغب في ذلك، يمكنك أيضًا تثبيت فرع التطوير عن طريق تشغيل composer require team-reflex/discord-php dev-master .

2. قم بتضمين ملف التحميل التلقائي للمؤلف في أعلى ملفك الرئيسي:

• include __DIR__.'/vendor/autoload.php';

3. اصنع روبوتًا!

مثال أساسي

 <?phpinclude __DIR__.'/vendor/autoload.php';use DiscordDiscord;use DiscordPartsChannelMessage;use DiscordWebSocketsIntents;use DiscordWebSocketsEvent;$discord = new Discord(['token' => 'bot-token','intents' => النوايا ::getDefaultIntents()// | Intents::MESSAGE_CONTENT, // ملاحظة: MESSAGE_CONTENT مميز، راجع https://dis.gd/mcfaq]);$discord->on('ready', function (Discord $discord) {echo "Bot جاهز!" , PHP_EOL;// استمع للرسائل.$discord->on(Event::MESSAGE_CREATE, function (Message $message, Discord $discord) {echo "{$message->author->username}: {$message->content}"، PHP_EOL;// ملاحظة: يجب تمكين نية MESSAGE_CONTENT للحصول على المحتوى إذا لم يتم ذكر الروبوت/DMed. });
});$discord->run();

راجع مجلد الأمثلة للمزيد.

التوثيق

يمكن العثور على وثائق الإصدار الأحدث هنا. يمكن العثور على البرامج التعليمية التي يساهم بها المجتمع على الويكي.

المساهمة

نحن منفتحون على المساهمات. ومع ذلك، يرجى التأكد من اتباع معايير الترميز لدينا (التحميل التلقائي PSR-4 والتصميم المخصص). يرجى تشغيل php-cs-fixer قبل فتح طلب السحب عن طريق تشغيل composer run-script cs .

رخصة

ترخيص معهد ماساتشوستس للتكنولوجيا، © ديفيد كول ومساهمون آخرون 2016 إلى الوقت الحاضر.