Laravel SQS Étendu
Directives de Support
- Support Axé sur la Communauté
- Bugs et Priorisation des Fonctionnalités
Licence - Licence MIT

Laravel SQS Étendu

Introduction

Laravel SQS Étendu est un pilote de file d'attente Laravel conçu pour contourner les limites de taille de charge utile de 256 Ko d'AWS SQS. Ce pilote de file d'attente va automatiquement sérialiser les grosses charges utiles sur un disque (typiquement S3) puis les désérialiser au moment de l'exécution. Ce paquet s'est inspiré de https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-s3-messages.html.

Migration depuis le Client Simple SQS Étendu

Supprimez le paquet simplesoftwareio/simple-sqs-extended-client de votre projet.
Installez le paquet defectivecode/laravel-sqs-extended.

L'ancienne configuration est rétrocompatible avec le nouveau paquet. Le seul changement concerne le nom du paquet.

Installation

Commencez par créer un seau qui contiendra toutes vos grandes charges utiles SQS.

Nous vous recommandons fortement d'utiliser un seau privé lors du stockage des charges utiles SQS. Les charges utiles peuvent contenir des informations sensibles et ne devraient jamais être partagées publiquement.

Exécutez composer require defectivecode/laravel-sqs-extended pour installer le pilote de file d'attente.
Ensuite, ajoutez les paramètres de file d'attente par défaut suivants à votre fichier queue.php.

Les utilisateurs de Laravel Vapor doivent définir le nom de connexion sur sqs. La connexion sqs est recherchée dans Vapor Core et cette bibliothèque ne fonctionnera pas comme prévu si vous utilisez un nom de connexion différent.

/*
|--------------------------------------------------------------------------
| Configuration de la File d'Attente SQS Disk
|--------------------------------------------------------------------------
|
| Ici, vous pouvez configurer le pilote de file d'attente SQS disk. Il partage toutes
| les mêmes options de configuration que le pilote de file d'attente SQS intégré de Laravel.
| La seule option ajoutée est `disk_options` qui est expliquée ci-dessous.
|
| always_store : Détermine si toutes les charges utiles doivent être stockées sur un disque peu importe si elles
|                 dépassent la limite de 256 Ko de SQS.
| cleanup :      Détermine si les fichiers de charge utile doivent être supprimés du disque une fois le travail
|                 traité. Laisser les fichiers peut être utile pour rejouer les travaux de file d'attente plus tard pour
|                 des raisons de débogage.
| disk :         Le disque pour sauvegarder les charges utiles SQS. Ce disque doit être configuré dans votre fichier
|                 de configuration Laravel filesystems.php.
| prefix :       Le préfixe (dossier) pour stocker les charges utiles. Cela est utile si vous partagez un disque
|                 avec d'autres files d'attente SQS. Utiliser un préfixe permet à la commande queue:clear de détruire
|                 les fichiers séparément des autres files d'attente basées sur le disque SQS partageant le même disque.
|
*/
'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',
    ],
],

Lancez vos files d'attente et profitez-en sans avoir à vous soucier de la limite de 256 Ko de SQS 🥳

Directives de Support

Merci d'avoir choisi notre paquet open source ! Veuillez prendre un moment pour consulter ces directives de support. Elles vous aideront à tirer le meilleur parti de notre projet.

Support Axé sur la Communauté

Notre projet open-source est alimenté par notre incroyable communauté. Si vous avez des questions ou avez besoin d'aide, StackOverflow et d'autres ressources en ligne sont vos meilleures options.

Bugs et Priorisation des Fonctionnalités

La réalité de la gestion d'un projet open-source signifie que nous ne pouvons pas traiter tous les bugs ou demandes de fonctionnalités immédiatement. Nous priorisons les problèmes dans l'ordre suivant :

1. Bugs Affectant Nos Produits Payants

Les bugs qui impactent nos produits payants seront toujours notre priorité absolue. Dans certains cas, nous ne traiterons peut-être que les bugs qui nous affectent directement.

2. Demandes de Tirage de la Communauté

Si vous avez identifié un bug et avez une solution, veuillez soumettre une demande de tirage. Après les problèmes affectant nos produits, nous accordons la prochaine priorité la plus élevée à ces corrections pilotées par la communauté. Une fois examinée et approuvée, nous fusionnerons votre solution et créditerons votre contribution.

3. Soutien Financier

Pour les problèmes en dehors des catégories mentionnées, vous pouvez choisir de financer leur résolution. Chaque problème ouvert est lié à un bon de commande où vous pouvez contribuer financièrement. Nous priorisons ces problèmes en fonction du montant du financement fourni.

Contributions de la Communauté

L'open-source prospère lorsque sa communauté est active. Même si vous ne réparez pas de bugs, envisagez de contribuer par des améliorations de code, des mises à jour de documentation, des tutoriels, ou en aidant les autres dans les canaux communautaires. Nous encourageons vivement tout le monde, en tant que communauté, à aider à soutenir le travail open-source.

Pour réitérer, DefectiveCode priorisera les bugs en fonction de leur impact sur nos produits payants, des demandes de tirage de la communauté, et du soutien financier reçu pour les problèmes.

Licence - Licence MIT

La permission est par la présente accordée, gratuitement, à toute personne obtenant une copie de ce logiciel et des fichiers de documentation associés (le "Logiciel"), de traiter le Logiciel sans restriction, y compris sans limitation les droits d'utiliser, de copier, de modifier, de fusionner, de publier, de distribuer, de sous-licencier, et/ou de vendre des copies du Logiciel, et de permettre aux personnes à qui le Logiciel est fourni de le faire, sous réserve des conditions suivantes :

L'avertissement de copyright ci-dessus et cet avis de permission doivent être inclus dans toutes les copies ou portions substantielles du Logiciel.

LE LOGICIEL EST FOURNI "EN L'ÉTAT", SANS GARANTIE D'AUCUNE SORTE, EXPRESSE OU TACITE, Y COMPRIS MAIS SANS S'Y LIMITER AUX GARANTIES DE COMMERCIALITÉ, D'ADAPTATION À UN OBJECTIF PARTICULIER ET DE NON CONTREFAÇON. EN AUCUN CAS, LES AUTEURS OU DÉTENTEURS DE DROITS D'AUTEUR NE POURRONT ÊTRE TENUS RESPONSABLES DE TOUTE RECLAMATION, DOMMAGE OU AUTRE RESPONSABILITÉ, QUE CE SOIT DANS LE CADRE D'UN CONTRAT, DUN DÉLIT OU AUTRE, DÉCOULANT DE, OU EN RELATION AVEC LE LOGICIEL OU L'UTILISATION OU AUTRES TRANSACTIONS DANS LE LOGICIEL.

🔗Laravel SQS Étendu

🔗Introduction

🔗Migration depuis le Client Simple SQS Étendu

🔗Installation

🔗Directives de Support

🔗Support Axé sur la Communauté

🔗Bugs et Priorisation des Fonctionnalités