# 번역 경고

이 문서는 자동으로 번역되었습니다. 번역 오류가 있는 경우 프로젝트의 pull request를 열고 번역된 파일을 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 큐와 디스크를 공유하는 경우 유용합니다.
|                 접두사를 사용하면 동일한 디스크를 공유하는 다른 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 라이선스
 
저작권 © Defective Code, LLC. 모든 권리 보유
 
본 소프트웨어 및 관련 문서 파일(이하 "소프트웨어")의 사본을 취득하는 모든 사람에게 사용, 복사, 수정, 병합, 출판, 배포, 서브라이선스 및/또는 소프트웨어의 사본을 판매할 권리를 포함하되 이에 국한되지 않고 소프트웨어를 제한 없이 다룰 수 있는 권한을 무료로 부여합니다. 또한 소프트웨어가 제공된 사람에게 다음 조건에 따라 이를 허용합니다:
 
**위의 저작권 고지 및 이 허가 고지는 소프트웨어의 모든 사본 또는 상당 부분에 포함되어야 합니다.**
 
본 소프트웨어는 "있는 그대로" 제공되며, 상품성, 특정 목적에의 적합성 및 비침해에 대한 보증을 포함하되 이에 국한되지 않고 명시적이거나 묵시적인 어떠한 종류의 보증도 제공되지 않습니다. 어떠한 경우에도 저자 또는 저작권 보유자는 계약, 불법 행위 또는 기타 행위로 인해 발생하는 소프트웨어 또는 소프트웨어 사용 또는 기타 거래와 관련된 모든 청구, 손해 또는 기타 책임에 대해 책임을 지지 않습니다.

🔗Laravel SQS Extended

🔗소개

🔗Simple SQS Extended Client에서의 마이그레이션

🔗설치

Laravel SQS Extended

소개

Simple SQS Extended Client에서의 마이그레이션

설치