Laravel SQS Extendido
Diretrizes de Suporte
- Suporte Direcionado pela Comunidade
- Erros e Priorização de Recursos
Licença - Licença MIT

Laravel SQS Extendido

Introdução

Laravel SQS Estendido é um driver de fila do Laravel projetado para contornar os limites de tamanho de carga útil de 256KB da AWS SQS. Esse driver de fila irá automaticamente serializar cargas úteis grandes em um disco (tipicamente S3) e, em seguida, deserializá-las 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 Cliente Simples SQS Estendido

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 biblioteca. A única mudança é o nome do pacote.

Instalação

Primeiro, crie um bucket que armazenará todas as suas grandes cargas úteis do SQS.

Recomendamos fortemente que você use um bucket privado ao armazenar cargas úteis do SQS. As cargas úteis podem conter informações sensíveis e nunca devem ser compartilhadas 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 do Laravel. A única opção adicionada
| é `disk_options`, que é explicada abaixo.
|
| always_store: Determina se todas as cargas úteis devem ser armazenadas em um disco, independentemente de estarem acima do limite de 256KB do SQS.
| cleanup:      Determina se os arquivos de carga útil devem ser removidos do disco assim que o trabalho for processado. Deixar os
|                 arquivos para trás pode ser útil para reproduzir os trabalhos da fila mais tarde por motivos de depuração.
| disk:         O disco onde as cargas úteis do SQS serão salvas. Este disco deve ser configurado no seu arquivo de configuração filesystems.php do Laravel.
| prefix:       O prefixo (pasta) para armazenar as cargas úteis. 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/seu-id-de-conta'),
    '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 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 aproveitar ao máximo nosso projeto.

Suporte Direcionado pela Comunidade

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

Erros e Priorização de Recursos

A realidade de gerenciar um projeto de código aberto significa que não podemos abordar imediatamente todos os erros ou solicitações de recursos relatados. Priorizamos as questões na seguinte ordem:

1. Erros que Afetam Nossos Produtos Pagos

Erros que impactam nossos produtos pagos serão sempre nossa maior prioridade. Em alguns casos, podemos abordar apenas erros que nos afetam diretamente.

2. Pull Requests da Comunidade

Se você identificou um erro e tem uma solução, por favor, envie um pull request. Após as questões que afetam nossos produtos, damos a próxima maior prioridade a essas correções impulsionadas pela comunidade. Uma vez revisada e aprovada, iremos mesclar sua solução e creditar sua contribuição.

3. Apoio Financeiro

Para questões fora das categorias mencionadas, você pode optar por financiar sua resolução. Cada problema em aberto está vinculado a um formulário de pedido onde você pode contribuir financeiramente. Priorizamos essas questões 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 erros, considere contribuir com melhorias de código, atualizações de documentação, tutoriais ou ajudando outros em canais da comunidade. Incentivamos fortemente todos, como comunidade, a ajudar a apoiar o trabalho de código aberto.

Para reiterar, a DefectiveCode priorizará erros com base em como eles impactam nossos produtos pagos, pull requests da comunidade e o apoio financeiro recebido para as questões.

Licença - Licença MIT

A permissão é concedida, sem qualquer custo, a qualquer pessoa que obter 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, fundir, publicar, distribuir, sublicenciar e/ou vender cópias do Software, e para permitir que pessoas a quem o Software é fornecido façam o mesmo, sujeito às seguintes condições:

O aviso de copyright acima e este aviso de permissão devem ser incluídos em todas as cópias ou porções substanciais do Software.

O SOFTWARE É FORNECIDO "COMO ESTÁ", SEM GARANTIA DE QUALQUER TIPO, EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO A GARANTIAS DE COMERCIALIZAÇÃO, ADEQUAÇÃO A UM FIM ESPECÍFICO E NÃO INFRAÇÃO. EM NENHUM CASO OS AUTORES OU DETENTORES DO DIREITO AUTORAL SERÃO RESPONSÁVEIS POR QUALQUER RECLAMAÇÃO, DANOS OU OUTRA RESPONSABILIDADE, SEJA EM AÇÃO DE CONTRATO, DELITO OU DE OUTRA FORMA, DECORRENTES DE, EM DECORRÊNCIA OU EM CONEXÃO COM O SOFTWARE OU O USO OU OUTRAS NEGOCIAÇÕES NO SOFTWARE.

🔗Laravel SQS Extendido

🔗Introdução

🔗Migração do Cliente Simples SQS Estendido

🔗Instalação

🔗Diretrizes de Suporte

🔗Suporte Direcionado pela Comunidade

🔗Erros e Priorização de Recursos