Laravel SQS Extended
Руководство по поддержке
- Поддержка, основанная на сообществе
- Ошибки и приоритизация функций
Лицензия - MIT Лицензия

Laravel SQS Extended

Введение

Laravel SQS Extended — это драйвер очередей Laravel, который был разработан с учетом ограничения размера полезной нагрузки AWS SQS в 256 КБ. Этот драйвер очередей автоматически сериализует большие полезные нагрузки на диск (обычно 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 на диске. Он разделяет все те же
| параметры конфигурации, что и встроенный драйвер очереди SQS Laravel. Единственный добавленный
| параметр — это `disk_options`, который объяснён ниже.
|
| always_store: Определяет, должны ли все полезные грузы храниться на диске, независимо от того, превышают ли они лимит SQS в 256 КБ.
| cleanup:      Определяет, следует ли удалять файлы полезных грузов с диска после обработки задания. Оставление
|                 файлов может быть полезно для повторного воспроизведения заданий очереди позже в целях отладки.
| disk:         Диск для сохранения полезных грузов SQS. Этот диск должен быть настроен в вашем конфигурационном файле Laravel filesystems.php.
| prefix        Префикс (папка) для хранения полезных грузов. Это полезно, если вы делите диск с другими очередями SQS.
|                 Использование префикса позволяет команде queue:clear удалять файлы отдельно от других очередей, поддерживаемых диском sqs,
|                 которые используют тот же диск.
|
*/
'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',
    ],
],

Запустите ваши очереди и получайте удовольствие, не беспокоясь о 256 КБ ограничении SQS 🥳

Руководство по поддержке

Спасибо, что выбрали наш пакет с открытым исходным кодом! Пожалуйста, уделите немного времени, чтобы ознакомиться с этими рекомендациями по поддержке. Они помогут вам максимально эффективно использовать наш проект.

Поддержка, основанная на сообществе

Наш проект с открытым исходным кодом поддерживается нашим замечательным сообществом. Если у вас есть вопросы или требуется помощь, StackOverflow и другие онлайн-ресурсы — ваши лучшие помощники.

Ошибки и приоритизация функций

Реальность управления проектом с открытым исходным кодом заключается в том, что мы не можем сразу же решить каждую сообщенную ошибку или запрос на новую функцию. Мы приоритизируем проблемы в следующем порядке:

1. Ошибки, влияющие на наши платные продукты

Ошибки, которые затрагивают наши платные продукты, всегда будут нашим приоритетом. В некоторых случаях мы можем рассматривать только те ошибки, которые влияют на нас напрямую.

2. Запросы на внесение изменений от сообщества

Если вы выявили ошибку и у вас есть решение, пожалуйста, отправьте запрос на внесение изменений. После вопросов, касающихся наших продуктов, мы придаем следующий высокий приоритет этим исправлениям, инициированным сообществом. После проверки и одобрения мы объединим ваше решение и отметим ваш вклад.

3. Финансовая поддержка

Для вопросов за пределами упомянутых категорий вы можете выбрать финансирование их решения. Каждая открытая проблема связана с формой заказа, через которую вы можете внести финансовый вклад. Мы приоритизируем эти вопросы на основе суммы финансирования.

Вклад сообщества

Проекты с открытым исходным кодом процветают, когда их сообщество активно. Даже если вы не исправляете ошибки, подумайте о том, чтобы внести вклад через улучшение кода, обновление документации, создание учебных пособий или помощь другим в каналах сообщества. Мы настоятельно призываем всех, как сообщество, поддерживать работу с открытым исходным кодом.

Повторим, что DefectiveCode будет приоритизировать ошибки в зависимости от того, как они влияют на наши платные продукты, запросы на внесение изменений от сообщества и финансовую поддержку, полученную за проблемы.

Лицензия - MIT Лицензия

Настоящим предоставляется разрешение, безвозмездно, любому лицу, получающему копию этого программного обеспечения и сопутствующих документационных файлов (далее «Программное обеспечение»), пользоваться Программным обеспечением без ограничений, включая, но не ограничиваясь правами использовать, копировать, изменять, сливать, публиковать, распространять, предоставлять сублицензии и/или продавать копии Программного обеспечения, а также разрешать лицам, которым предоставляется Программное обеспечение, делать это, при соблюдении следующих условий:

Указанные выше авторские права и данное разрешение должны быть включены во все копии или значительные части Программного обеспечения.

ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ ГАРАНТИЙ ЛЮБОГО ВИДА, ЯВНЫХ ИЛИ ИМПЛИЦИТНЫХ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ, ГАРАНТИЯМИ ТОРГОВОЙ ПРИГОДНОСТИ, ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЁННЫХ ЦЕЛЕЙ И НАРУШЕНИЯ ПРАВ. В НИКАКОМ СЛУЧАЕ АВТОРЫ ИЛИ ДЕРЖАТЕЛИ АВТОРСКИХ ПРАВ НЕ НЕСУТ ОТВЕТСТВЕННОСТЬ ЗА ЛЮБЫЕ ИСКИ, УЩЕРБ ИЛИ ДРУГИЕ ОБЯЗАТЕЛЬСТВА, НИ В КАКОМ УКАЗАНИИ, ДОГОВОРЕ, ДЕЛИКТЕ ИЛИ ИНОМ, ВЫТЕКАЮЩИЕ ИЗ, ИЛИ В СВЯЗИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ ИЛИ ИСПОЛЬЗОВАНИЕМ ИЛИ ДРУГИМИ СДЕЛКАМИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ.

🔗Laravel SQS Extended

🔗Введение

🔗Переход от Simple SQS Extended Client

🔗Установка

🔗Руководство по поддержке

🔗Поддержка, основанная на сообществе

🔗Ошибки и приоритизация функций