# 翻訳警告

このドキュメントは自動的に翻訳されています。翻訳エラーがある場合は、プロジェクトのプルリクエストを開き、翻訳されたファイルを docs/{ISO 639-1 Code}.md に追加してください。

Laravel SQS Extended

Laravel SQS Extended

紹介

Laravel SQS Extendedは、AWS SQSの256KBペイロードサイズ制限を回避するために設計されたLaravelキュードライバーです。このキュードライバーは、大きなペイロードを自動的にディスク（通常はS3）にシリアライズし、実行時にそれを逆シリアライズします。このパッケージは、https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-s3-messages.html からインスピレーションを得ています。

Simple SQS Extended Clientからの移行

プロジェクトから 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ライセンス
 
Copyright © Defective Code, LLC. All rights reserved
 
本ソフトウェアおよび関連するドキュメントファイル（以下「ソフトウェア」）のコピーを取得したすべての人に対し、無償で、以下の条件に従い、ソフトウェアを制限なく使用、コピー、改変、統合、公開、配布、サブライセンス、および/または販売する権利を許可します。また、ソフトウェアが提供された人々にこれを行うことを許可します。
 
**上記の著作権表示およびこの許可表示は、ソフトウェアのすべてのコピーまたは重要な部分に含まれるものとします。**
 
ソフトウェアは「現状のまま」提供され、明示または黙示を問わず、商品性、特定の目的への適合性、および非侵害についての保証を含むがこれに限定されない、いかなる種類の保証もありません。著者または著作権者は、契約行為、不法行為、またはその他の行為に起因または関連して生じるいかなる請求、損害、またはその他の責任についても責任を負いません。

🔗Laravel SQS Extended

🔗紹介

🔗Simple SQS Extended Clientからの移行

🔗インストール

Laravel SQS Extended

紹介

Simple SQS Extended Clientからの移行

インストール