English | العربية | বাংলা | Bosanski | Deutsch | Español | Français | हिन्दी | Italiano | 日本語 | 한국어 | मराठी | Português | Русский | Kiswahili | தமிழ் | తెలుగు | Türkçe | اردو | Tiếng Việt | 中文

# تحذير الترجمة

تمت ترجمة هذا المستند تلقائيًا. إذا كانت هناك أخطاء في الترجمة، يرجى فتح طلب سحب على المشروع وإضافة الملف المترجم إلى docs/{ISO 639-1 Code}.md.

• لارافيل SQS Extended
  • مقدمة
  • الانتقال من Simple SQS Extended Client
  • التثبيت
• إرشادات الدعم
  • دعم المجتمع
  • الأخطاء وأولويات الميزات

🔗لارافيل SQS Extended

🔗مقدمة

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

🔗الانتقال من Simple SQS Extended Client

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

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

🔗التثبيت

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

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

2. قم بتشغيل composer require defectivecode/laravel-sqs-extended لتثبيت محرك الطابور.

3. ثم، أضف إعدادات الطابور الافتراضية التالية إلى ملف queue.php الخاص بك.

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

/*
|--------------------------------------------------------------------------
| تكوين طابور قرص SQS
|--------------------------------------------------------------------------
|
| هنا يمكنك تكوين محرك طابور قرص SQS. يشارك جميع خيارات التكوين نفسها من محرك طابور SQS المدمج في لارافيل.
| الخيار المضاف الوحيد هو `disk_options` التي تم شرحها أدناه.
|
| always_store: يحدد ما إذا كان يجب تخزين جميع الحمولات على قرص بغض النظر عما إذا كانت تتجاوز حد 256KB لـ SQS.
| cleanup:      يحدد ما إذا كان يجب إزالة ملفات الحمولة من القرص بمجرد معالجة الوظيفة. ترك الملفات يمكن أن يكون مفيدًا لإعادة تشغيل وظائف الطابور لاحقًا لأغراض التصحيح.
| disk:         القرص لحفظ حمولات SQS عليه. يجب تكوين هذا القرص في ملف تكوين أنظمة الملفات في لارافيل.
| 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',
    ],
],

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

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

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

🔗دعم المجتمع

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

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

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

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

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

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

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

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

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

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

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

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

# الرخصة - رخصة MIT
 
حقوق الطبع والنشر © Defective Code, LLC. جميع الحقوق محفوظة
 
يتم بموجب هذا منح الإذن، مجانًا، لأي شخص يحصل على نسخة من هذا البرنامج والملفات التوثيقية المرتبطة به ("البرنامج")، للتعامل مع البرنامج دون قيود، بما في ذلك على سبيل المثال لا الحصر حقوق الاستخدام، النسخ، التعديل، الدمج، النشر، التوزيع، الترخيص الفرعي، و/أو بيع نسخ من البرنامج، والسماح للأشخاص الذين يتم توفير البرنامج لهم بالقيام بذلك، وفقًا للشروط التالية:
 
**يجب تضمين إشعار حقوق الطبع والنشر أعلاه وهذا الإذن في جميع النسخ أو الأجزاء الكبيرة من البرنامج.**
 
يتم توفير البرنامج "كما هو"، دون أي ضمان من أي نوع، صريح أو ضمني، بما في ذلك على سبيل المثال لا الحصر ضمانات القابلية للتسويق، الملاءمة لغرض معين وعدم الانتهاك. في أي حال من الأحوال لن يكون المؤلفون أو أصحاب حقوق الطبع والنشر مسؤولين عن أي مطالبة، أضرار أو أي مسؤولية أخرى، سواء في عقد، ضرر أو غير ذلك، تنشأ عن، خارج أو فيما يتعلق بالبرنامج أو استخدامه أو التعاملات الأخرى في البرنامج.