PHPackages g41797/queue-sqs - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Queues & Workers](/categories/queues) 4. / 5. g41797/queue-sqs ActiveLibrary[Queues & Workers](/categories/queues) g41797/queue-sqs ================ Yii Queue Adapter for AWS SQS v0.0.2(1y ago)021[1 issues](https://github.com/g41797/queue-sqs/issues)[1 PRs](https://github.com/g41797/queue-sqs/pulls)BSD-3-ClausePHPPHP >=8.2 Since Jun 22Pushed 1y ago1 watchersCompare [ Source](https://github.com/g41797/queue-sqs)[ Packagist](https://packagist.org/packages/g41797/queue-sqs)[ RSS](/packages/g41797-queue-sqs/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (13)Versions (3)Used By (0) Yii3 Queue Adapter for Amazon Simple Queue Service (AWS SQS) ============================================================ [](#yii3-queue-adapter-for-amazon-simple-queue-service-aws-sqs) [![tests](https://github.com/g41797/queue-sqs/actions/workflows/tests.yml/badge.svg)](https://github.com/g41797/queue-sqs/actions/workflows/tests.yml) Description ----------- [](#description) Yii3 Queue Adapter for [**AWS SQS**](https://aws.amazon.com/documentation-overview/sqs/) is new adapter in [Yii3 Queue Adapters family.](https://github.com/yiisoft/queue/blob/master/docs/guide/en/adapter-list.md) Implementation of adapter is based on [enqueue/sqs](https://github.com/php-enqueue/sqs) library. Requirements ------------ [](#requirements) - PHP 8.2 or higher. Installation ------------ [](#installation) The package could be installed with composer: ``` composer require g41797/queue-sqs ``` General usage ------------- [](#general-usage) - As part of [Yii3 Queue Framework](https://github.com/yiisoft/queue/blob/master/docs/guide/en/README.md) - Stand-alone Configuration ------------- [](#configuration) Default configuration: ``` [ 'key' => null, // AWS credentials. If no credentials are provided, the SDK will attempt to load them from the environment. 'secret' => null, // AWS credentials. If no credentials are provided, the SDK will attempt to load them from the environment. 'token' => null, // AWS credentials. If no credentials are provided, the SDK will attempt to load them from the environment. 'region' => us-east-1, // (string, required) Region to connect to. See http://docs.aws.amazon.com/general/latest/gr/rande.html for a list of available regions. 'retries' => 3, // (int, default=int(3)) Configures the maximum number of allowed retries for a client (pass 0 to disable retries). 'version' => 'latest', // (string, required) The version of the webservice to utilize 'profile' => null, // (string, default=null) The name of an AWS profile to used, if provided the SDK will attempt to read associated credentials from the ~/.aws/credentials file. 'queue_owner_aws_account_id' // The AWS account ID of the account that created the queue. ] ``` Yandex Message Queue -------------------- [](#yandex-message-queue) According to [Yandex blog](https://habr.com/ru/companies/yandex/articles/455642/): > "...we decided not to invent a unique interface for Yandex Message Queue, > but implement support for the AWS SQS API, and very carefully." It means that *queue-sqs* supports [Yandex Message Queue](https://yandex.cloud/en/services/message-queue), but this use case was not tested. LocalStack usage ---------------- [](#localstack-usage) [LocalStack](https://www.localstack.cloud/) allows "...develop and test your AWS applications locally to reduce development time...". Development and testing of queue-sqs were done using LocalStack. ### Credentials [](#credentials) LocalStack does not require AWS credentials. Functional tests use following credentials: ``` [ 'key' => 'anyKey', 'secret' => 'noSecrets', ] ``` ### Endpoint [](#endpoint) [AWS SDK for PHP](https://github.com/aws/aws-sdk-php) automatically builds required SQS endpoint. Under LocalStack "hard-coded" endpoint is saved in phpunit configuration file: ``` ``` *queue-sqs* checks existence of **ENDPOINT** and initiates AWS library accordingly. ### Auth Token [](#auth-token) [Auth Token](https://app.localstack.cloud/workspace/auth-token) is used for authentication and to retrieve your LocalStack license. You can see example in [startup script](https://github.com/g41797/queue-sqs/blob/master/docker/start.sh) ``` export LOCALSTACK_AUTH_TOKEN="ls-KESiVaLi-4697-7857-MEna-ziqIXeSaf962" ``` Replace this token with your one. Limitations ----------- [](#limitations) ### Job Status [](#job-status) [Job Status](https://github.com/yiisoft/queue/blob/master/docs/guide/en/usage.md#job-status) ``` // Push a job into the queue and get a message ID. $id = $queue->push(new SomeJob()); // Get job status. $status = $queue->status($id); ``` is not supported. ### SQS limitations [](#sqs-limitations) A lot of information you can find in [Amazon SQS FAQs](https://www.amazonaws.cn/en/sqs/faqs/) #### Channel Name [](#channel-name) - Length limited to 75 chars - Contains only alphanumeric characters, hyphens (-), and underscores (\_) #### Cross region/account communication [](#cross-regionaccount-communication) Cross region/account communications are not supported. #### Long polling [](#long-polling) Worker uses polling timeout for retrieving messages(jobs) from SQS. Because customer pays for every receive, it's recommended to use long value for this timeout. Maximal value is 20 sec, this value is used also for zero timeout. More information see [Amazon SQS short and long polling](https://docs.amazonaws.cn/en_us/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-short-and-long-polling.html) License ------- [](#license) Yii3 Queue Adapter for AWS SQS is free software. It is released under the terms of the BSD License. Please see [`LICENSE`](./LICENSE.md) for more information. ### Health Score 23 — LowBetter than 27% of packages Maintenance32 Infrequent updates — may be unmaintained Popularity3 Limited adoption so far Community8 Small or concentrated contributor base Maturity44 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 695d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/309983e881b60fdc511151d24a73a52513278045d773700d3372011d85acbfd3?d=identicon)[g41797](/maintainers/g41797) --- Top Contributors [![g41797](https://avatars.githubusercontent.com/u/9116281?v=4)](https://github.com/g41797 "g41797 (36 commits)") --- Tags awslocalstackphpqueuesqsyandex-message-queueyiiqueuesqsyii3 ### Code Quality TestsPHPUnit Static AnalysisPsalm, Rector Type Coverage Yes ### Embed Badge ![Health badge](/badges/g41797-queue-sqs/health.svg) ``` [![Health](https://phpackages.com/badges/g41797-queue-sqs/health.svg)](https://phpackages.com/packages/g41797-queue-sqs) ``` ### Alternatives [shiftonelabs/laravel-sqs-fifo-queue Adds a Laravel queue driver for Amazon SQS FIFO queues. 1556.0M3](/packages/shiftonelabs-laravel-sqs-fifo-queue)[enqueue/sqs Message Queue Amazon SQS Transport 376.3M14](/packages/enqueue-sqs)[joblocal/laravel-sqs-sns-subscription-queue A simple Laravel service provider which adds a new queue connector to handle SNS subscription queues. 48416.3k](/packages/joblocal-laravel-sqs-sns-subscription-queue)[atymic/laravel-bulk-sqs-queue Laravel SQS Bulk Queue 15184.3k](/packages/atymic-laravel-bulk-sqs-queue)[maqe/laravel-sqs-fifo Laravel package that enables support for SQS FIFO Queue 15137.2k](/packages/maqe-laravel-sqs-fifo)[pod-point/laravel-aws-pubsub A Laravel broadcasting driver and queue driver that broadcasts and listens to published events utilising AWS SNS, EventBridge and SQS. 1096.1k](/packages/pod-point-laravel-aws-pubsub) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)