# Übersetzungswarnung

Dieses Dokument wurde automatisch übersetzt. Wenn es Übersetzungsfehler gibt, öffnen Sie bitte einen Pull Request im Projekt und fügen Sie die übersetzte Datei zu docs/{ISO 639-1 Code}.md hinzu.

Laravel SQS Extended
Unterstützungsrichtlinien
- Community-getriebene Unterstützung
- Fehler und Feature-Priorisierung
Lizenz - MIT-Lizenz

Laravel SQS Extended

Einführung

Laravel SQS Extended ist ein Laravel-Queue-Treiber, der entwickelt wurde, um die AWS SQS 256KB-Payload-Größenbeschränkungen zu umgehen. Dieser Queue-Treiber serialisiert automatisch große Payloads auf eine Festplatte (typischerweise S3) und deserialisiert sie dann zur Laufzeit. Dieses Paket wurde inspiriert von https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-s3-messages.html.

Migration vom Simple SQS Extended Client

Entfernen Sie das Paket simplesoftwareio/simple-sqs-extended-client aus Ihrem Projekt.
Installieren Sie das Paket defectivecode/laravel-sqs-extended.

Die alte Konfiguration ist rückwärtskompatibel mit dem neuen Paket. Die einzige Änderung ist der Paketname.

Installation

Erstellen Sie zuerst einen Bucket, der alle Ihre großen SQS-Payloads aufnehmen wird.

Wir empfehlen dringend, einen privaten Bucket zu verwenden, wenn Sie SQS-Payloads speichern. Payloads können sensible Informationen enthalten und sollten niemals öffentlich geteilt werden.

Führen Sie composer require defectivecode/laravel-sqs-extended aus, um den Queue-Treiber zu installieren.
Fügen Sie dann die folgenden Standard-Queue-Einstellungen zu Ihrer queue.php-Datei hinzu.

Laravel Vapor-Benutzer müssen den Verbindungsnamen auf sqs setzen. Die sqs-Verbindung wird innerhalb von Vapor Core gesucht und diese Bibliothek funktioniert nicht wie erwartet, wenn Sie einen anderen Verbindungsnamen verwenden.

/*
|--------------------------------------------------------------------------
| SQS Disk Queue Konfiguration
|--------------------------------------------------------------------------
|
| Hier können Sie den SQS-Disk-Queue-Treiber konfigurieren. Er teilt alle
| Konfigurationsoptionen des eingebauten Laravel SQS-Queue-Treibers. Die einzige
| hinzugefügte Option ist `disk_options`, die unten erklärt werden.
|
| always_store: Bestimmt, ob alle Payloads auf einer Festplatte gespeichert werden sollen, unabhängig davon, ob sie das 256KB-Limit von SQS überschreiten.
| cleanup:      Bestimmt, ob die Payload-Dateien von der Festplatte entfernt werden sollen, sobald der Job verarbeitet ist. Das Zurücklassen der
|                 Dateien kann nützlich sein, um die Queue-Jobs später zu Debugging-Zwecken erneut abzuspielen.
| disk:         Die Festplatte, auf der SQS-Payloads gespeichert werden sollen. Diese Festplatte sollte in Ihrer Laravel-Datei filesystems.php konfiguriert sein.
| prefix        Das Präfix (Ordner), unter dem die Payloads gespeichert werden sollen. Dies ist nützlich, wenn Sie eine Festplatte mit anderen SQS-Queues teilen.
|                 Die Verwendung eines Präfixes ermöglicht es dem Befehl queue:clear, die Dateien getrennt von anderen SQS-Disk-gestützten Queues zu löschen,
|                 die dieselbe Festplatte teilen.
|
*/
'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',
    ],
],

Starten Sie Ihre Queues und profitieren Sie, ohne sich um das 256KB-Limit von SQS sorgen zu müssen 🥳

Unterstützungsrichtlinien

Danke, dass Sie sich für unser Open-Source-Paket entschieden haben! Bitte nehmen Sie sich einen Moment Zeit, um diese Unterstützungsrichtlinien zu lesen. Sie helfen Ihnen, das Beste aus unserem Projekt herauszuholen.

Community-getriebene Unterstützung

Unser Open-Source-Projekt wird von unserer großartigen Community angetrieben. Wenn Sie Fragen haben oder Unterstützung benötigen, sind StackOverflow und andere Online-Ressourcen Ihre besten Anlaufstellen.

Fehler und Feature-Priorisierung

Die Realität der Verwaltung eines Open-Source-Projekts bedeutet, dass wir nicht jeden gemeldeten Fehler oder Feature-Anfrage sofort bearbeiten können. Wir priorisieren Probleme in der folgenden Reihenfolge:

1. Fehler, die unsere kostenpflichtigen Produkte betreffen

Fehler, die unsere kostenpflichtigen Produkte betreffen, haben immer oberste Priorität. In einigen Fällen beheben wir möglicherweise nur Fehler, die uns direkt betreffen.

2. Community-Pull-Requests

Wenn Sie einen Fehler identifiziert haben und eine Lösung haben, reichen Sie bitte einen Pull-Request ein. Nach den Problemen, die unsere Produkte betreffen, geben wir diesen Community-getriebenen Korrekturen die nächsthöhere Priorität. Nach der Überprüfung und Genehmigung werden wir Ihre Lösung zusammenführen und Ihren Beitrag anerkennen.

3. Finanzielle Unterstützung

Für Probleme außerhalb der genannten Kategorien können Sie deren Lösung finanziell unterstützen. Jedes offene Problem ist mit einem Bestellformular verknüpft, über das Sie finanziell beitragen können. Wir priorisieren diese Probleme basierend auf dem bereitgestellten Finanzierungsbetrag.

Community-Beiträge

Open Source gedeiht, wenn seine Community aktiv ist. Auch wenn Sie keine Fehler beheben, sollten Sie in Erwägung ziehen, durch Code-Verbesserungen, Dokumentationsaktualisierungen, Tutorials oder durch Unterstützung anderer in Community-Kanälen beizutragen. Wir ermutigen alle, als Gemeinschaft, die Open-Source-Arbeit zu unterstützen.

Um es noch einmal zu wiederholen: DefectiveCode wird Fehler basierend darauf priorisieren, wie sie unsere kostenpflichtigen Produkte betreffen, Community-Pull-Requests und die erhaltene finanzielle Unterstützung für Probleme.

Lizenz - MIT-Lizenz

Hiermit wird unentgeltlich jeder Person, die eine Kopie dieser Software und der zugehörigen Dokumentationsdateien (die "Software") erhält, die Erlaubnis erteilt, in der Software uneingeschränkt zu handeln, einschließlich und ohne Einschränkung der Rechte zur Nutzung, Kopie, Änderung, Zusammenführung, Veröffentlichung, Verteilung, Unterlizenzierung und/oder zum Verkauf von Kopien der Software, und Personen, denen die Software zur Verfügung gestellt wird, dies zu erlauben, vorbehaltlich der folgenden Bedingungen:

Der obige Urheberrechtshinweis und dieser Erlaubnishinweis müssen in allen Kopien oder wesentlichen Teilen der Software enthalten sein.

DIE SOFTWARE WIRD "WIE BESEHEN" BEREITGESTELLT, OHNE JEGLICHE GEWÄHRLEISTUNG, AUSDRÜCKLICH ODER IMPLIZIERT, EINSCHLIESSLICH ABER NICHT BESCHRÄNKT AUF DIE GEWÄHRLEISTUNGEN DER MARKTGÄNGIGKEIT, EIGNUNG FÜR EINEN BESTIMMTEN ZWECK UND NICHTVERLETZUNG. IN KEINEM FALL SIND DIE AUTOREN ODER URHEBERRECHTSINHABER FÜR JEGLICHE ANSPRÜCHE, SCHÄDEN ODER ANDERE HAFTUNGEN VERANTWORTLICH, OB IN EINEM VERTRAG, EINER UNERLAUBTEN HANDLUNG ODER ANDERWEITIG, DIE AUS, AUS ODER IM ZUSAMMENHANG MIT DER SOFTWARE ODER DER VERWENDUNG ODER ANDEREN GESCHÄFTEN IN DER SOFTWARE ENTSTEHEN.

🔗Laravel SQS Extended

🔗Einführung

🔗Migration vom Simple SQS Extended Client

🔗Installation

🔗Unterstützungsrichtlinien

🔗Community-getriebene Unterstützung

🔗Fehler und Feature-Priorisierung