لارافيل SQS موسع
إرشادات الدعم
- دعم مدفوع من المجتمع
- الأخطاء، وأولوية الميزات
الترخيص - MIT License

لارافيل SQS موسع

المقدمة

لارافيل SQS موسع هو سائق طابور لارافيل تم تصميمه للعمل حول حدود حجم الحمولة البالغة 256KB الخاصة بـ AWS SQS. سيقوم هذا السائق تلقائيًا بتسلسل الحمولات الكبيرة إلى قرص (عادةً S3) ثم فك تسلسلها في وقت التشغيل. استلهمت هذه الحزمة من https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-s3-messages.html.

الترحيل من عميل SQS الموسع البسيط

قم بإزالة حزمة simplesoftwareio/simple-sqs-extended-client من مشروعك.
قم بتثبيت حزمة defectivecode/laravel-sqs-extended.

التكوين القديم متوافق مع الحزمة الجديدة. التغيير الوحيد هو اسم الحزمة.

التثبيت

أولاً، قم بإنشاء دلو سيحتوي على جميع حمولات SQS الكبيرة الخاصة بك.

نوصي بشدة باستخدام دلو خاص عند تخزين حمولات SQS. يمكن أن تحتوي الحمولة على معلومات حساسة ويجب ألا تتم مشاركتها علنًا.

قم بتشغيل composer require defectivecode/laravel-sqs-extended لتثبيت سائق الطابور.
ثم، أضف إعدادات الطابور الافتراضية التالية إلى ملف queue.php الخاص بك.

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

/*
|--------------------------------------------------------------------------
| تهيئة طابور SQS على القرص
|--------------------------------------------------------------------------
|
| هنا يمكنك تكوين سائق طابور SQS على القرص.  يشارك جميع خيارات
| التهيئة من سائق طابور لارافيل SQS المدمج.  الخيارات الوحيدة المضافة
| هي `disk_options` التي سيتم توضيحها أدناه.
|
| always_store: يحدد ما إذا كان يجب تخزين جميع الحمولات على قرص بغض النظر عما إذا كانت تتجاوز حد 256KB الخاص بـ SQS.
| cleanup:     يحدد ما إذا كان يجب إزالة ملفات الحمولة من القرص بمجرد معالجة الوظيفة. قد يكون ترك
|                 الملفات مفيدًا لإعادة تشغيل الوظائف في الطابور لاحقًا لأغراض_debug_.
| disk:        القرص الذي سيتم حفظ حمولات SQS عليه. ينبغي تكوين هذا القرص في ملف التهيئة filesystems.php الخاص بك في لارافيل.
| prefix:      البادئة (المجلد) لتخزين الحمولات به.  هذا مفيد إذا كنت تشارك قرصًا مع طوابير SQS أخرى.
|                 يسمح استخدام بادئة لأمر queue:clear بتدمير الملفات بشكل منفصل عن الطوابير المدعومة من sqs-disk الأخرى
|                 التي تشارك نفس القرص.
|
*/
'sqs' => [
    'driver' => 'sqs-disk',
    'key' => env('AWS_ACCESS_KEY_ID'),
    'secret' => env('AWS_SECRET_ACCESS_KEY'),
    'prefix' => env('SQS_PREFIX', 'https://sqs.us-east-1.amazonaws.com/your-account-id'),
    'queue' => env('SQS_QUEUE', 'default'),
    'suffix' => env('SQS_SUFFIX'),
    'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),
    'after_commit' => false,
    'disk_options' => [
        'always_store' => false,
        'cleanup' => false,
        'disk' => env('SQS_DISK'),
        'prefix' => 'bucket-prefix',
    ],
],

قم بتشغيل طوابيرك واستفد دون الحاجة للقلق بشأن حد 256KB الخاص بـ SQS 🥳

إرشادات الدعم

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

دعم مدفوع من المجتمع

مشروعنا مفتوح المصدر مدعوم من مجتمعنا الرائع. إذا كانت لديك أسئلة أو تحتاج إلى مساعدة، فإن StackOverflow وغيرها من الموارد عبر الإنترنت هي أفضل الخيارات لديك.

الأخطاء، وأولوية الميزات

حقيقة إدارة مشروع مفتوح المصدر تعني أنه لا يمكننا معالجة كل خطأ أو طلب ميزة مبلّغ عنه على الفور. نحن نحدد أولويات المشكلات بالترتيب التالي:

1. الأخطاء التي تؤثر على منتجاتنا المدفوعة

الأخطاء التي تؤثر على منتجاتنا المدفوعة ستكون دائمًا أولويتنا القصوى. في بعض الحالات، قد نعمل فقط على معالجة الأخطاء التي تؤثر علينا بشكل مباشر.

2. طلبات السحب من المجتمع

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

3. الدعم المالي

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

مساهمات المجتمع

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

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

الترخيص - MIT License

يتم منح الإذن بموجب هذا، مجانًا، لأي شخص يحصل على نسخة من هذا البرنامج وملفات الوثائق المرتبطة (الـ"برنامج")، للتعامل في البرنامج دون قيود، بما في ذلك بدون حصر الحقوق في الاستخدام والنسخ والتعديل والدمج والنشر والتوزيع والتراخيص الفرعية و/أو بيع نسخ من البرنامج، والسماح للأشخاص الذين تم تقديم البرنامج لهم بذلك، بشرط الالتزام بالشروط التالية:

يجب تضمين إشعار حقوق الطبع والنشر أعلاه وإشعار الإذن هذا في جميع النسخ أو الأجزاء الجوهرية من البرنامج.

يتم توفير البرنامج "كما هو"، دون أي ضمان من أي نوع، صريح أو ضمني، بما في ذلك ولكن لا تقتصر على ضمانات القابلية للتسويق، والملاءمة لغرض معين وعدم الانتهاك. في أي حال من الأحوال، لا يتحمل المؤلفون أو أصحاب حقوق الطبع المسؤولية عن أي مطالبة أو أضرار أو مسؤوليات أخرى، سواء كانت في إطار عقد أو ضرر أو خلاف ذلك، ناشئة عن أو نتيجة عن أو تتعلق بالبرنامج أو الاستخدام أو التعاملات الأخرى في البرنامج.

🔗لارافيل SQS موسع

🔗المقدمة

🔗الترحيل من عميل SQS الموسع البسيط

🔗التثبيت

🔗إرشادات الدعم

🔗دعم مدفوع من المجتمع

🔗الأخطاء، وأولوية الميزات