zhamao framework

إطار أفريقي

Zhamao-framework عبارة عن إطار عمل لتطوير خادم الويب + chatbot عالي الأداء

مجموعة المطورين QQ: 670821194 انقر للانضمام إلى الدردشة الجماعية

إذا كان هناك مطورين يرغبون في العمل معًا لتطوير إطار العمل نفسه، فيرجى إرسال رسالة عامة أو مشكلة للمشاركة في التطوير! إذا كانت لديك أفكار أفضل حول التصميم الأساسي لإطار العمل نفسه، فيمكنك إعداد فريق تطوير مع المؤلف (حاليًا شخصين فقط) للمشاركة في تطوير النظام البيئي OneBot V12 والإطار نفسه.

راجع عمود المشاريع للتعرف على مهام الإصدار المستمر ذات الصلة!

مقدمة

تمت كتابة إطار عمل Zhamao بلغة PHP وهو موجه بشكل أساسي إلى خدمات واجهة برمجة التطبيقات (API) وروبوتات الدردشة، ويتضمن Websocket وHTTP ومكتبات المراقبة والطلب الأخرى. رمز المستخدم نموذجي ويمكن كتابة الوظائف المختلفة بسهولة باستخدام التعليقات التوضيحية.

الغرض الرئيسي من الإطار هو خادم HTTP وإطار بناء الروبوت. خاصة بالنسبة لمعالجة رسائل chatbot، فهو أكثر ملاءمة وشمولاً ويوفر العديد من آليات المحادثة وآليات الاتصال الداخلية، ويمكنك تصميم المكونات الإضافية الخاصة بك بطرق مختلفة.

 #[BotCommand('Hello')]public function hello(BotContext $ctx) { $ctx->reply("مرحبًا، أنا تشا ماو!"); // رد ضروري بسيط};
#[Route('/index')]public function Index() { return "<h1>hello!</h1>" // تطوير خدمة HTTP السريعة};

يبدأ

يدعم إطار العمل حاليًا التشغيل المباشر في بيئات Linux وWSL وmacOS وWindows. بالنسبة لبيئات Linux وmacOS، يمكنك استخدام البرنامج النصي للتثبيت بنقرة واحدة مباشرةً أدناه.

إذا كنت تريد التثبيت والنشر في بيئات أخرى، فيمكنك استخدام Docker لنشر البيئة بسرعة أو تثبيتها يدويًا ثم تثبيت إطار العمل.

 # Linux وmacOS، انقر بعد ذلك لاكتشاف بيئة PHP وتثبيت إطار العمل bash <(curl -fsSL https://zhamao.xin/v3.sh)# بدء تشغيل إطار العمل cd zhamao-v3
./خادم زاماو

يتيح لك البرنامج النصي للتثبيت بنقرة واحدة أيضًا تخصيص المعلمات، مثل:

 # سيكتشف البرنامج النصي PHP الخاص بالنظام افتراضيًا، إذا كنت تريد تخطي الاكتشاف مباشرةً وتثبيت إصدار PHP مستقل، فأضف متغير البيئة هذا Export ZM_NO_LOCAL_PHP="yes" # إذا قام البرنامج النصي بتثبيت إصدار مستقل من PHP، فسيكون الإصدار الافتراضي. هو 8.1. إذا كنت تريد استخدام إصدار آخر، أضف متغير البيئة هذا لتحديد إصدار التصدير ZM_DOWN_PHP_VERSION = "8.2" # افتراضيًا، سيقوم البرنامج النصي بتخزين "zhamao-app" الخاص بإطار العمل في الدليل الحالي. دليل التثبيت إذا كنت تريد استخدام دليل آخر، أضف متغير البيئة هذا Export ZM_CUSTOM_DIR="my-custom-app"# سيستخدم البرنامج النصي صورة التسريع المحلية لـ Alibaba Cloud لهذا المشروع بشكل افتراضي المصدر، أضف متغير البيئة هذاexport ZM_COMPOSER_PACKAGIST="yes"# بعد تنفيذ متغيرات البيئة السابقة ثم تنفيذ البرنامج النصي للتثبيت بنقرة واحدة، يمكنك تنفيذ المعلمات المخصصة! باش <(curl -fsSL https://zhamao.xin/v3.sh)

راجع الوثائق لمعرفة طرق التثبيت البديلة.

وثيقة

عرض المستند (تم إنشاؤه ذاتيًا في الصين): https://framework.zhamao.xin/

الرابط البديل (الاستضافة الأجنبية): https://framework.zhamao.me/

سمات

• الدعم الأصلي لعملاء الروبوت المتعددين للاتصال في وقت واحد

• آلية ربط حدث التعليق التوضيحي المرنة، والتي يمكنها استخدام التعليقات التوضيحية والتعليقات التوضيحية للسمة الأصلية في نفس الوقت

• نظام المكونات الإضافية الكامل، يمكن كتابة المكونات الإضافية وتعبئتها أو توزيعها ليستخدمها الآخرون.

• مكتوب بتنسيق مكون إضافي، ويمكن دمجه بحرية مع مكونات Composer الأخرى، أو يمكن كتابته في ملف واحد للمعالجة

• يدعم تعبئة الوحدات والتحميل الساخن، مما يجعلها أكثر ملاءمة لمشاركة الوحدات

• يمكن استخدام متغيرات ذاكرة التخزين المؤقت العامة الموجودة في الذاكرة في كل مكان، مما يوفر مجموعة متنوعة من حلول التخزين المؤقت

• يأتي مع MySQL وSQLite وRedis وتجمعات اتصال قواعد البيانات الأخرى

• إنه خادم HTTP وخادم WebSocket، ويمكنك إنشاء واجهة HTTP API الخاصة بك.

• بيئة PHP مدمجة اختيارية، لا حاجة للتجميع والتثبيت يدويًا، بواسطة Crazywhalecc/static-php-cli

المساهمات والتبرعات

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

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

تم تطوير هذا المشروع في وقت فراغ المؤلف، إذا وجدت أنه مفيد، فقد ترغب في التبرع. سوف يمنحني تبرعك المزيد من الحافز لتحسين البرنامج الإضافي.

سوف نستخدم الأموال المتبرع بها لتغطية نفقات خادم Explosive Bot ووثائق إطار العمل التي يقودها هذا المشروع. قائمة التبرعات

إذا كنت لا ترغب في المشاركة بشكل مباشر في تطوير إطار العمل، فيمكنك أيضًا مشاركة الوحدات النمطية التي كتبتها للمساعدة في تحسين النظام البيئي لإطار العمل.

أليباي

عن

يعد الإطار وSDK الأجزاء الأساسية مفتوحة المصدر لمشروع Explosive Robot. الروبوت المتفجر هو روبوت عالي الأداء من تأليف المؤلف، وقد فاز بالجائزة الأولى في المسابقة الوطنية لتصميم الكمبيوتر.

يعمل الروبوت المتفجر الخاص بالمؤلف بثبات لمدة خمس سنوات منذ بداية عام 2018 ويستمر في التكرار.

يمكنك إرسال مشكلة أو الانضمام إلى المجموعة (670821194) لاستكشاف الأخطاء وإصلاحها.

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

إطار عمل المشروع مفتوح المصدر باستخدام بروتوكول Apache-2.0، ويجب اتباع البروتوكول عند توزيعه أو إعادة كتابته وتعديله. يمكن توزيع جزء البرنامج الإضافي للمشروع (المجلدات بخلاف مجلدات src/Globals و src/ZM ) وتعديله دون الالتزام ببروتوكول Apache-2.0 (إعلان حقوق الطبع والنشر) عند عدم الإشارة إلى التعليمات البرمجية داخل إطار العمل.

ملحوظة : عند استخدام برنامج روبوت بروتوكول AGPL-3.0 مثل mirai للاتصال بإطار العمل، فإن استخدام هذا الإطار يتطلب منك إعادة توزيع الأجزاء التي كتبتها أو قمت بتعديلها باستخدام بروتوكول AGPL-3.0 .

عند المساهمة بالتعليمات البرمجية، يرجى الحفاظ على المعلومات الحساسة في ملف التكوين العام الخاص بك آمنة، وعدم تحميل ملفات التكوين مع المعلومات الشخصية إلى مواقع الويب مثل GitHub.

شكرًا لـ JetBrains لتوفير دعم أداة تطوير PhpStorm لهذا المشروع مفتوح المصدر:

شكرًا للمطور @sunxyw على بعض الاقتراحات لتوحيد تطوير المشروع.