# Предупреждение о переводе

Этот документ был переведен автоматически. Если есть ошибки перевода, пожалуйста, откройте запрос на внесение изменений в проекте и добавьте переведенный файл в docs/{ISO 639-1 Code}.md.

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

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

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

Поддержка, Управляемая Сообществом

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

Ошибки и Приоритизация Функций

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

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

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

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

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

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

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

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

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

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

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

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

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

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

🔗Laravel SQS Extended

🔗Введение

🔗Миграция с Simple SQS Extended Client

🔗Установка

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

🔗Поддержка, Управляемая Сообществом

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