Laravel SQS Extended - Defective Code

# Cảnh Báo Dịch Thuật

Tài liệu này đã được dịch tự động. Nếu có lỗi dịch thuật, vui lòng mở một pull request trên dự án và thêm tệp đã dịch vào docs/{ISO 639-1 Code}.md.

# Laravel SQS Extended
 
## Giới thiệu
 
Laravel SQS Extended là một driver hàng đợi Laravel được thiết kế để vượt qua giới hạn kích thước payload 256KB của AWS SQS. Driver hàng đợi này sẽ tự động tuần tự hóa các payload lớn vào đĩa (thường là S3) và sau đó giải tuần tự hóa chúng khi chạy. Gói này lấy cảm hứng từ https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-s3-messages.html.
 
## Di chuyển từ Simple SQS Extended Client
 
1. Gỡ bỏ gói `simplesoftwareio/simple-sqs-extended-client` khỏi dự án của bạn.
2. Cài đặt gói `defectivecode/laravel-sqs-extended`.
 
Cấu hình cũ tương thích ngược với gói mới. Thay đổi duy nhất là tên gói.
 
## Cài đặt
 
1. Đầu tiên, tạo một bucket để chứa tất cả các payload SQS lớn của bạn.
 
> Chúng tôi khuyến nghị bạn sử dụng một bucket _riêng tư_ khi lưu trữ các payload SQS. Payload có thể chứa thông tin nhạy cảm và không bao giờ nên được chia sẻ công khai.
 
2. Chạy `composer require defectivecode/laravel-sqs-extended` để cài đặt driver hàng đợi.
 
3. Sau đó, thêm các cài đặt hàng đợi mặc định sau vào tệp `queue.php` của bạn.
 
> Người dùng Laravel Vapor phải đặt tên kết nối là `sqs`. Kết nối `sqs` được tìm kiếm trong Vapor Core và thư viện này sẽ không hoạt động như mong đợi nếu bạn sử dụng tên kết nối khác.

/* |--------------------------------------------------------------------------

Cấu hình hàng đợi đĩa SQS

Ở đây bạn có thể cấu hình driver hàng đợi đĩa SQS. Nó chia sẻ tất cả các tùy chọn
cấu hình từ driver hàng đợi SQS tích hợp sẵn của Laravel. Tùy chọn duy nhất được thêm vào
là `disk_options` được giải thích dưới đây.

always_store: Xác định xem tất cả các payload có nên được lưu trữ trên đĩa bất kể chúng có vượt quá giới hạn 256KB của SQS hay không.
cleanup: Xác định xem các tệp payload có nên được xóa khỏi đĩa sau khi công việc được xử lý hay không. Để lại các
tệp có thể hữu ích để phát lại các công việc hàng đợi sau này cho mục đích gỡ lỗi.
disk: Đĩa để lưu trữ các payload SQS. Đĩa này nên được cấu hình trong tệp cấu hình filesystems.php của Laravel.
prefix Tiền tố (thư mục) để lưu trữ các payload. Điều này hữu ích nếu bạn đang chia sẻ một đĩa với các hàng đợi SQS khác.
Sử dụng tiền tố cho phép lệnh queue:clear phá hủy các tệp riêng biệt từ các hàng đợi sqs-disk khác
chia sẻ cùng một đĩa.

*/
'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. Khởi động hàng đợi của bạn và tận hưởng mà không phải lo lắng về giới hạn 256KB của SQS 🥳

# Hướng Dẫn Hỗ Trợ

Cảm ơn bạn đã chọn gói mã nguồn mở của chúng tôi! Vui lòng dành chút thời gian để xem qua các hướng dẫn hỗ trợ này. Chúng sẽ giúp bạn tận dụng tối đa dự án của chúng tôi.

Hỗ Trợ Dựa Trên Cộng Đồng
Lỗi và Ưu Tiên Tính Năng

Hỗ Trợ Dựa Trên Cộng Đồng

Dự án mã nguồn mở của chúng tôi được thúc đẩy bởi cộng đồng tuyệt vời của chúng tôi. Nếu bạn có câu hỏi hoặc cần trợ giúp, StackOverflow và các tài nguyên trực tuyến khác là lựa chọn tốt nhất của bạn.

Lỗi và Ưu Tiên Tính Năng

Thực tế của việc quản lý một dự án mã nguồn mở có nghĩa là chúng tôi không thể giải quyết ngay lập tức mọi lỗi hoặc yêu cầu tính năng được báo cáo. Chúng tôi ưu tiên các vấn đề theo thứ tự sau:

1. Lỗi Ảnh Hưởng Đến Sản Phẩm Trả Phí Của Chúng Tôi

Các lỗi ảnh hưởng đến sản phẩm trả phí của chúng tôi sẽ luôn là ưu tiên hàng đầu của chúng tôi. Trong một số trường hợp, chúng tôi chỉ giải quyết các lỗi ảnh hưởng trực tiếp đến chúng tôi.

2. Yêu Cầu Kéo Từ Cộng Đồng

Nếu bạn đã xác định được một lỗi và có giải pháp, vui lòng gửi yêu cầu kéo. Sau các vấn đề ảnh hưởng đến sản phẩm của chúng tôi, chúng tôi ưu tiên cao nhất cho các bản sửa lỗi do cộng đồng đóng góp. Sau khi được xem xét và phê duyệt, chúng tôi sẽ hợp nhất giải pháp của bạn và ghi nhận sự đóng góp của bạn.

3. Hỗ Trợ Tài Chính

Đối với các vấn đề ngoài các danh mục đã đề cập, bạn có thể chọn tài trợ cho việc giải quyết chúng. Mỗi vấn đề mở đều được liên kết với một biểu mẫu đặt hàng nơi bạn có thể đóng góp tài chính. Chúng tôi ưu tiên các vấn đề này dựa trên số tiền tài trợ được cung cấp.

Đóng Góp Cộng Đồng

Mã nguồn mở phát triển mạnh khi cộng đồng của nó hoạt động. Ngay cả khi bạn không sửa lỗi, hãy xem xét đóng góp thông qua cải tiến mã, cập nhật tài liệu, hướng dẫn, hoặc hỗ trợ người khác trong các kênh cộng đồng. Chúng tôi khuyến khích mạnh mẽ mọi người, như một cộng đồng, hỗ trợ công việc mã nguồn mở.

Để nhắc lại, DefectiveCode sẽ ưu tiên các lỗi dựa trên cách chúng ảnh hưởng đến sản phẩm trả phí của chúng tôi, các yêu cầu kéo từ cộng đồng, và sự hỗ trợ tài chính nhận được cho các vấn đề.

# Giấy phép - Giấy phép MIT
 
Bản quyền © Defective Code, LLC. Bảo lưu mọi quyền
 
Quyền được cấp miễn phí cho bất kỳ cá nhân nào có được bản sao của phần mềm này và các tệp tài liệu liên quan (gọi là "Phần mềm"), để sử dụng Phần mềm mà không bị hạn chế, bao gồm nhưng không giới hạn quyền sử dụng, sao chép, sửa đổi, hợp nhất, xuất bản, phân phối, cấp phép lại và/hoặc bán các bản sao của Phần mềm, và cho phép các cá nhân mà Phần mềm được cung cấp để làm như vậy, tuân theo các điều kiện sau:
 
**Thông báo bản quyền trên và thông báo cấp phép này phải được bao gồm trong tất cả các bản sao hoặc phần lớn của Phần mềm.**
 
PHẦN MỀM ĐƯỢC CUNG CẤP "NGUYÊN TRẠNG", KHÔNG CÓ BẢO HÀNH DƯỚI BẤT KỲ HÌNH THỨC NÀO, DÙ LÀ RÕ RÀNG HAY NGỤ Ý, BAO GỒM NHƯNG KHÔNG GIỚI HẠN CÁC BẢO HÀNH VỀ KHẢ NĂNG MUA BÁN, PHÙ HỢP VỚI MỤC ĐÍCH CỤ THỂ VÀ KHÔNG VI PHẠM. TRONG MỌI TRƯỜNG HỢP, CÁC TÁC GIẢ HOẶC CHỦ SỞ HỮU BẢN QUYỀN KHÔNG CHỊU TRÁCH NHIỆM VỀ BẤT KỲ YÊU CẦU, THIỆT HẠI HOẶC TRÁCH NHIỆM NÀO KHÁC, DÙ LÀ TRONG HỢP ĐỒNG, SAI LẦM CÁ NHÂN HAY CÁCH KHÁC, PHÁT SINH TỪ, NGOÀI HOẶC LIÊN QUAN ĐẾN PHẦN MỀM HOẶC VIỆC SỬ DỤNG HOẶC CÁC GIAO DỊCH KHÁC TRONG PHẦN MỀM.

🔗Hỗ Trợ Dựa Trên Cộng Đồng

🔗Lỗi và Ưu Tiên Tính Năng