# Aviso de Tradução

Este documento foi traduzido automaticamente. Se houver erros de tradução, por favor abra um pull request no projeto e adicione o arquivo traduzido em docs/{Código ISO 639-1}.md.

Laravel SQS Extended
Diretrizes de Suporte
- Suporte Orientado pela Comunidade
- Bugs e Priorização de Funcionalidades
Licença - Licença MIT

Laravel SQS Extended

Introdução

Laravel SQS Extended é um driver de fila do Laravel que foi projetado para contornar os limites de tamanho de payload de 256KB do AWS SQS. Este driver de fila irá automaticamente serializar payloads grandes para um disco (tipicamente S3) e depois desserializá-los em tempo de execução. Este pacote se inspirou em https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-s3-messages.html.

Migração do Simple SQS Extended Client

Remova o pacote simplesoftwareio/simple-sqs-extended-client do seu projeto.
Instale o pacote defectivecode/laravel-sqs-extended.

A configuração antiga é compatível com a nova. A única mudança é o nome do pacote.

Instalação

Primeiro, crie um bucket que armazenará todos os seus payloads grandes do SQS.

Recomendamos fortemente que você use um bucket privado ao armazenar payloads do SQS. Os payloads podem conter informações sensíveis e nunca devem ser compartilhados publicamente.

Execute composer require defectivecode/laravel-sqs-extended para instalar o driver de fila.
Em seguida, adicione as seguintes configurações padrão de fila ao seu arquivo queue.php.

Usuários do Laravel Vapor devem definir o nome da conexão como sqs. A conexão sqs é procurada dentro do Vapor Core e esta biblioteca não funcionará como esperado se você usar um nome de conexão diferente.

/*
|--------------------------------------------------------------------------
| Configuração da Fila de Disco SQS
|--------------------------------------------------------------------------
|
| Aqui você pode configurar o driver de fila de disco SQS. Ele compartilha todas as mesmas
| opções de configuração do driver de fila SQS embutido no Laravel. A única opção adicionada
| é `disk_options`, que são explicadas abaixo.
|
| always_store: Determina se todos os payloads devem ser armazenados em um disco, independentemente de estarem acima do limite de 256KB do SQS.
| cleanup:      Determina se os arquivos de payload devem ser removidos do disco uma vez que o trabalho é processado. Deixar os
|                 arquivos para trás pode ser útil para reproduzir os trabalhos da fila mais tarde para fins de depuração.
| disk:         O disco para salvar os payloads do SQS. Este disco deve ser configurado no seu arquivo de configuração filesystems.php do Laravel.
| prefix        O prefixo (pasta) para armazenar os payloads. Isso é útil se você estiver compartilhando um disco com outras filas SQS.
|                 Usar um prefixo permite que o comando queue:clear destrua os arquivos separadamente de outras filas baseadas em disco SQS
|                 que compartilham o mesmo disco.
|
*/
'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',
    ],
],

Inicie suas filas e aproveite sem ter que se preocupar com o limite de 256KB do SQS 🥳

Diretrizes de Suporte

Obrigado por escolher nosso pacote de código aberto! Por favor, reserve um momento para conferir estas diretrizes de suporte. Elas ajudarão você a tirar o máximo proveito do nosso projeto.

Suporte Orientado pela Comunidade

Nosso projeto de código aberto é impulsionado por nossa incrível comunidade. Se você tiver perguntas ou precisar de assistência, StackOverflow e outros recursos online são suas melhores opções.

Bugs e Priorização de Funcionalidades

A realidade de gerenciar um projeto de código aberto significa que não podemos resolver todos os bugs relatados ou pedidos de funcionalidades imediatamente. Priorizamos os problemas na seguinte ordem:

1. Bugs que Afetam Nossos Produtos Pagos

Bugs que impactam nossos produtos pagos sempre serão nossa maior prioridade. Em alguns casos, podemos resolver apenas bugs que nos afetam diretamente.

2. Pull Requests da Comunidade

Se você identificou um bug e tem uma solução, por favor, envie um pull request. Após resolver os problemas que afetam nossos produtos, damos a próxima maior prioridade a essas correções impulsionadas pela comunidade. Uma vez revisada e aprovada, integraremos sua solução e creditaremos sua contribuição.

3. Suporte Financeiro

Para problemas fora das categorias mencionadas, você pode optar por financiar sua resolução. Cada problema aberto está vinculado a um formulário de pedido onde você pode contribuir financeiramente. Priorizamos esses problemas com base no valor do financiamento fornecido.

Contribuições da Comunidade

O código aberto prospera quando sua comunidade é ativa. Mesmo que você não esteja corrigindo bugs, considere contribuir através de melhorias no código, atualizações na documentação, tutoriais ou ajudando outros nos canais da comunidade. Incentivamos fortemente todos, como comunidade, a ajudar a apoiar o trabalho de código aberto.

Para reiterar, a DefectiveCode priorizará bugs com base em como eles impactam nossos produtos pagos, pull requests da comunidade e o suporte financeiro recebido para os problemas.

Licença - Licença MIT

A permissão é concedida, gratuitamente, a qualquer pessoa que obtenha uma cópia deste software e dos arquivos de documentação associados (o "Software"), para lidar com o Software sem restrições, incluindo, sem limitação, os direitos de usar, copiar, modificar, mesclar, publicar, distribuir, sublicenciar e/ou vender cópias do Software, e permitir que as pessoas a quem o Software é fornecido façam isso, sujeitas às seguintes condições:

O aviso de copyright acima e esta permissão devem ser incluídos em todas as cópias ou partes substanciais do Software.

O SOFTWARE É FORNECIDO "COMO ESTÁ", SEM GARANTIA DE QUALQUER TIPO, EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS DE COMERCIABILIDADE, ADEQUAÇÃO A UM DETERMINADO FIM E NÃO VIOLAÇÃO. EM NENHUM CASO OS AUTORES OU DETENTORES DOS DIREITOS AUTORAIS SERÃO RESPONSÁVEIS POR QUALQUER REIVINDICAÇÃO, DANOS OU OUTRA RESPONSABILIDADE, SEJA EM UMA AÇÃO DE CONTRATO, DELITO OU DE OUTRA FORMA, DECORRENTE DE, FORA OU EM CONEXÃO COM O SOFTWARE OU O USO OU OUTRAS NEGOCIAÇÕES NO SOFTWARE.

🔗Laravel SQS Extended

🔗Introdução

🔗Migração do Simple SQS Extended Client

🔗Instalação

🔗Diretrizes de Suporte

🔗Suporte Orientado pela Comunidade

🔗Bugs e Priorização de Funcionalidades