Laravel SQS 拡張

はじめに

Laravel SQS 拡張は、AWS SQS の 256KB ペイロードサイズ制限を回避するために設計された Laravel キュードライバです。このキュードライバは、大きなペイロードを自動的にディスク（通常は 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 ファイルに追加します。

Laravel Vapor のユーザーは接続名を sqs に設定する必要があります。sqs 接続は Vapor Core 内で探され、このライブラリは異なる接続名を使用すると期待通りに動作しません。

/*
|--------------------------------------------------------------------------
| SQS ディスク キュー構成
|--------------------------------------------------------------------------
|
| ここでは SQS ディスクキュードライバを構成できます。 これは、組み込みの Laravel SQS キュードライバの
| 設定オプションとすべて同じです。追加された唯一のオプションは、以下で説明する `disk_options` です。
|
| always_store: すべてのペイロードを SQS の 256KB 制限を超えてもディスクに保存するかどうかを決定します。
| cleanup:      ジョブが処理された後にペイロードファイルをディスクから削除するかどうかを決定します。
|                 ファイルを残すことは、デバッグ理由で後でキュージョブをリプレイするために便利です。
| disk:         SQS ペイロードを保存するディスク。このディスクは Laravel の 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',
    ],
],

キューを起動し、SQS の 256KB 制限を心配することなく利益を得ましょう 🥳

サポートガイドライン

私たちのオープンソースパッケージを選んでいただきありがとうございます！これらのサポートガイドラインを確認するための時間を取ってください。プロジェクトを最大限に活用する助けになるでしょう。

コミュニティ主導のサポート

私たちのオープンソースプロジェクトは、素晴らしいコミュニティによって支えられています。質問がある場合や支援が必要な場合は、StackOverflowやその他のオンラインリソースが最良の選択です。

バグと機能の優先順位付け

オープンソースプロジェクトを管理する現実として、報告されたすべてのバグや機能リクエストに即座に対応することはできません。以下の順序で問題を優先します。

1. 有料製品に影響を与えるバグ

有料製品に影響を与えるバグは常に最優先事項となります。場合によっては、私たちに直接影響を与えるバグのみを扱うことがあります。

2. コミュニティのプルリクエスト

バグを特定し、解決策を持っている場合は、プルリクエストを提出してください。私たちの製品に影響を与える問題の次に、これらのコミュニティ主導の修正に対して最も高い優先順位を与えます。レビューと承認が行われた後、あなたの解決策をマージし、貢献を認めます。

3. 財政的サポート

上記のカテゴリー以外の問題については、その解決に資金を提供することができます。各オープンイシューには、財政的に貢献できる注文フォームへのリンクがあります。提供された資金額に基づいて、これらの問題を優先します。

コミュニティの貢献

オープンソースは、そのコミュニティが活発であるときに栄えます。バグを修正していない場合でも、コード改善、ドキュメントの更新、チュートリアルの作成、またはコミュニティチャネルで他の人を支援することで貢献を考えてください。私たちは、コミュニティとしてオープンソースの仕事を支援することを皆さんに強く奨励します。

繰り返しになりますが、DefectiveCodeは、有料製品にどのように影響を与えるか、コミュニティのプルリクエスト、そして問題に対して受け取った財政的サポートに基づいてバグを優先します.

ライセンス - MITライセンス

本ソフトウェア及び関連する文書ファイル（以下「ソフトウェア」）のコピーを取得したすべての人に対して、無償で本ソフトウェアを制限なく利用する権利、使用、複製、修正、統合、出版、配布、サブライセンス、及び／またはソフトウェアのコピーを販売する権利を許可し、ソフトウェアが提供される人々にもそれを行うことを許可します。ただし、以下の条件に従います：

上記の著作権表示とこの許可通知は、ソフトウェアのすべてのコピーまたは重要な部分に含まれるものとします。

ソフトウェアは「現状のまま」提供され、いかなる種類の保証もなく、明示または暗示を問わず、商業性、特定の目的への適合性および非侵害の保証を含むが、これに限定されない保証はありません。著作者または著作権者は、契約、不法行為、またはその他の方法によるいかなる請求、損害、またはその他の責任についても、ソフトウェアまたはソフトウェアの使用またはその他の取り扱いに起因する場合において、一切の責任を負わないものとします。

🔗Laravel SQS 拡張

🔗はじめに

🔗シンプル SQS 拡張クライアントからの移行

🔗インストール

🔗サポートガイドライン

🔗コミュニティ主導のサポート

🔗バグと機能の優先順位付け