diff -pruN 2.6.0-1/CHANGELOG.md 2.7.0-1/CHANGELOG.md --- 2.6.0-1/CHANGELOG.md 2025-05-12 09:35:01.000000000 +0000 +++ 2.7.0-1/CHANGELOG.md 2025-08-11 10:03:27.000000000 +0000 @@ -2,6 +2,16 @@ ## NOT RELEASED +## 2.7.0 + +### Added + +- AWS api-change: Rework regions configuration + +### Changed + +- AWS enhancement: Documentation updates. + ## 2.6.0 ### Added diff -pruN 2.6.0-1/composer.json 2.7.0-1/composer.json --- 2.6.0-1/composer.json 2025-05-12 09:35:01.000000000 +0000 +++ 2.7.0-1/composer.json 2025-08-11 10:03:27.000000000 +0000 @@ -28,7 +28,7 @@ }, "extra": { "branch-alias": { - "dev-master": "2.6-dev" + "dev-master": "2.7-dev" } } } diff -pruN 2.6.0-1/debian/changelog 2.7.0-1/debian/changelog --- 2.6.0-1/debian/changelog 2025-05-12 16:42:51.000000000 +0000 +++ 2.7.0-1/debian/changelog 2025-08-12 11:18:34.000000000 +0000 @@ -1,3 +1,12 @@ +php-async-aws-sqs (2.7.0-1) unstable; urgency=medium + + * Upload to unstable now that Trixie has been released + + [ Jérémy Derussé ] + * prepare next release (#1932) + + -- David Prévot Tue, 12 Aug 2025 13:18:34 +0200 + php-async-aws-sqs (2.6.0-1) experimental; urgency=medium * Upload to experimental during the freeze diff -pruN 2.6.0-1/src/Input/ReceiveMessageRequest.php 2.7.0-1/src/Input/ReceiveMessageRequest.php --- 2.6.0-1/src/Input/ReceiveMessageRequest.php 2025-05-12 09:35:01.000000000 +0000 +++ 2.7.0-1/src/Input/ReceiveMessageRequest.php 2025-08-11 10:03:27.000000000 +0000 @@ -47,8 +47,7 @@ final class ReceiveMessageRequest extend * - `SqsManagedSseEnabled` – Enables server-side queue encryption using SQS owned encryption keys. Only one * server-side encryption option is supported per queue (for example, SSE-KMS [^3] or SSE-SQS [^4]). * - `MessageDeduplicationId` – Returns the value provided by the producer that calls the `SendMessage` action. - * - `MessageGroupId` – Returns the value provided by the producer that calls the `SendMessage` action. Messages with - * the same `MessageGroupId` are returned in sequence. + * - `MessageGroupId` – Returns the value provided by the producer that calls the `SendMessage` action. * - `SequenceNumber` – Returns the value provided by Amazon SQS. * * [^1]: http://en.wikipedia.org/wiki/Unix_time @@ -157,7 +156,7 @@ final class ReceiveMessageRequest extend * * - While messages with a particular `MessageGroupId` are invisible, no more messages belonging to the same * `MessageGroupId` are returned until the visibility timeout expires. You can still receive messages with another - * `MessageGroupId` as long as it is also visible. + * `MessageGroupId` from your FIFO queue as long as they are visible. * - If a caller of `ReceiveMessage` can't track the `ReceiveRequestAttemptId`, no retries work until the original * visibility timeout expires. As a result, delays might occur but the messages in the queue remain in a strict order. * diff -pruN 2.6.0-1/src/Input/SendMessageRequest.php 2.7.0-1/src/Input/SendMessageRequest.php --- 2.6.0-1/src/Input/SendMessageRequest.php 2025-05-12 09:35:01.000000000 +0000 +++ 2.7.0-1/src/Input/SendMessageRequest.php 2025-08-11 10:03:27.000000000 +0000 @@ -32,7 +32,7 @@ final class SendMessageRequest extends I * ! `#x9` | `#xA` | `#xD` | `#x20` to `#xD7FF` | `#xE000` to `#xFFFD` | `#x10000` to `#x10FFFF` * ! * ! Amazon SQS does not throw an exception or completely reject the message if it contains invalid characters. Instead, - * ! it replaces those invalid characters with `U+FFFD` before storing the message in the queue, as long as the message + * ! it replaces those invalid characters with U+FFFD before storing the message in the queue, as long as the message * ! body contains at least one valid character. * * [^1]: http://www.w3.org/TR/REC-xml/#charsets @@ -123,27 +123,37 @@ final class SendMessageRequest extends I private $messageDeduplicationId; /** - * This parameter applies only to FIFO (first-in-first-out) queues. - * - * The tag that specifies that a message belongs to a specific message group. Messages that belong to the same message - * group are processed in a FIFO manner (however, messages in different message groups might be processed out of order). - * To interleave multiple ordered streams within a single queue, use `MessageGroupId` values (for example, session data - * for multiple users). In this scenario, multiple consumers can process the queue, but the session data of each user is - * processed in a FIFO fashion. - * - * - You must associate a non-empty `MessageGroupId` with a message. If you don't provide a `MessageGroupId`, the action - * fails. - * - `ReceiveMessage` might return messages with multiple `MessageGroupId` values. For each `MessageGroupId`, the - * messages are sorted by time sent. The caller can't specify a `MessageGroupId`. + * `MessageGroupId` is an attribute used in Amazon SQS FIFO (First-In-First-Out) and standard queues. In FIFO queues, + * `MessageGroupId` organizes messages into distinct groups. Messages within the same message group are always processed + * one at a time, in strict order, ensuring that no two messages from the same group are processed simultaneously. In + * standard queues, using `MessageGroupId` enables fair queues. It is used to identify the tenant a message belongs to, + * helping maintain consistent message dwell time across all tenants during noisy neighbor events. Unlike FIFO queues, + * messages with the same `MessageGroupId` can be processed in parallel, maintaining the high throughput of standard + * queues. + * + * - **FIFO queues:**`MessageGroupId` acts as the tag that specifies that a message belongs to a specific message group. + * Messages that belong to the same message group are processed in a FIFO manner (however, messages in different + * message groups might be processed out of order). To interleave multiple ordered streams within a single queue, use + * `MessageGroupId` values (for example, session data for multiple users). In this scenario, multiple consumers can + * process the queue, but the session data of each user is processed in a FIFO fashion. + * + * If you do not provide a `MessageGroupId` when sending a message to a FIFO queue, the action fails. + * + * `ReceiveMessage` might return messages with multiple `MessageGroupId` values. For each `MessageGroupId`, the + * messages are sorted by time sent. + * - **Standard queues:**Use `MessageGroupId` in standard queues to enable fair queues. The `MessageGroupId` identifies + * the tenant a message belongs to. A tenant can be any entity that shares a queue with others, such as your customer, + * a client application, or a request type. When one tenant sends a disproportionately large volume of messages or has + * messages that require longer processing time, fair queues ensure other tenants' messages maintain low dwell time. + * This preserves quality of service for all tenants while maintaining the scalability and throughput of standard + * queues. We recommend that you include a `MessageGroupId` in all messages when using fair queues. * - * The maximum length of `MessageGroupId` is 128 characters. Valid values: alphanumeric characters and punctuation + * The length of `MessageGroupId` is 128 characters. Valid values: alphanumeric characters and punctuation * `(!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~)`. * * For best practices of using `MessageGroupId`, see Using the MessageGroupId Property [^1] in the *Amazon SQS Developer * Guide*. * - * ! `MessageGroupId` is required for FIFO queues. You can't use it for Standard queues. - * * [^1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagegroupid-property.html * * @var string|null diff -pruN 2.6.0-1/src/SqsClient.php 2.7.0-1/src/SqsClient.php --- 2.6.0-1/src/SqsClient.php 2025-05-12 09:35:01.000000000 +0000 +++ 2.7.0-1/src/SqsClient.php 2025-08-11 10:03:27.000000000 +0000 @@ -6,7 +6,6 @@ use AsyncAws\Core\AbstractApi; use AsyncAws\Core\AwsError\AwsErrorFactoryInterface; use AsyncAws\Core\AwsError\JsonRpcAwsErrorFactory; use AsyncAws\Core\Configuration; -use AsyncAws\Core\Exception\UnsupportedRegion; use AsyncAws\Core\RequestContext; use AsyncAws\Core\Result; use AsyncAws\Sqs\Enum\MessageSystemAttributeName; @@ -258,7 +257,7 @@ class SqsClient extends AbstractApi * * > You can't change the queue type after you create it and you can't convert an existing standard queue into a FIFO * > queue. You must either create a new FIFO queue for your application or delete your existing standard queue and - * > recreate it as a FIFO queue. For more information, see Moving From a Standard Queue to a FIFO Queue [^1] in the + * > recreate it as a FIFO queue. For more information, see Moving From a standard queue to a FIFO queue [^1] in the * > *Amazon SQS Developer Guide*. * * - If you don't provide a value for an attribute, the queue is created with the default value for the attribute. @@ -746,7 +745,7 @@ class SqsClient extends AbstractApi * ! `#x9` | `#xA` | `#xD` | `#x20` to `#xD7FF` | `#xE000` to `#xFFFD` | `#x10000` to `#x10FFFF` * ! * ! Amazon SQS does not throw an exception or completely reject the message if it contains invalid characters. Instead, - * ! it replaces those invalid characters with `U+FFFD` before storing the message in the queue, as long as the message + * ! it replaces those invalid characters with U+FFFD before storing the message in the queue, as long as the message * ! body contains at least one valid character. * * [^1]: http://www.w3.org/TR/REC-xml/#charsets @@ -819,7 +818,7 @@ class SqsClient extends AbstractApi * ! `#x9` | `#xA` | `#xD` | `#x20` to `#xD7FF` | `#xE000` to `#xFFFD` | `#x10000` to `#x10FFFF` * ! * ! Amazon SQS does not throw an exception or completely reject the message if it contains invalid characters. Instead, - * ! it replaces those invalid characters with `U+FFFD` before storing the message in the queue, as long as the message + * ! it replaces those invalid characters with U+FFFD before storing the message in the queue, as long as the message * ! body contains at least one valid character. * * If you don't specify the `DelaySeconds` parameter for an entry, Amazon SQS uses the default value for the queue. @@ -891,44 +890,6 @@ class SqsClient extends AbstractApi } switch ($region) { - case 'af-south-1': - case 'ap-east-1': - case 'ap-northeast-1': - case 'ap-northeast-2': - case 'ap-northeast-3': - case 'ap-south-1': - case 'ap-south-2': - case 'ap-southeast-1': - case 'ap-southeast-2': - case 'ap-southeast-3': - case 'ap-southeast-4': - case 'ap-southeast-5': - case 'ap-southeast-7': - case 'ca-central-1': - case 'ca-west-1': - case 'eu-central-1': - case 'eu-central-2': - case 'eu-north-1': - case 'eu-south-1': - case 'eu-south-2': - case 'eu-west-1': - case 'eu-west-2': - case 'eu-west-3': - case 'il-central-1': - case 'me-central-1': - case 'me-south-1': - case 'mx-central-1': - case 'sa-east-1': - case 'us-east-1': - case 'us-east-2': - case 'us-west-1': - case 'us-west-2': - return [ - 'endpoint' => "https://sqs.$region.amazonaws.com", - 'signRegion' => $region, - 'signService' => 'sqs', - 'signVersions' => ['v4'], - ]; case 'cn-north-1': case 'cn-northwest-1': return [ @@ -980,7 +941,6 @@ class SqsClient extends AbstractApi 'signVersions' => ['v4'], ]; case 'fips-us-gov-east-1': - case 'us-gov-east-1': return [ 'endpoint' => 'https://sqs.us-gov-east-1.amazonaws.com', 'signRegion' => 'us-gov-east-1', @@ -988,7 +948,6 @@ class SqsClient extends AbstractApi 'signVersions' => ['v4'], ]; case 'fips-us-gov-west-1': - case 'us-gov-west-1': return [ 'endpoint' => 'https://sqs.us-gov-west-1.amazonaws.com', 'signRegion' => 'us-gov-west-1', @@ -1044,7 +1003,12 @@ class SqsClient extends AbstractApi ]; } - throw new UnsupportedRegion(\sprintf('The region "%s" is not supported by "Sqs".', $region)); + return [ + 'endpoint' => "https://sqs.$region.amazonaws.com", + 'signRegion' => $region, + 'signService' => 'sqs', + 'signVersions' => ['v4'], + ]; } protected function getServiceCode(): string diff -pruN 2.6.0-1/src/ValueObject/SendMessageBatchRequestEntry.php 2.7.0-1/src/ValueObject/SendMessageBatchRequestEntry.php --- 2.6.0-1/src/ValueObject/SendMessageBatchRequestEntry.php 2025-05-12 09:35:01.000000000 +0000 +++ 2.7.0-1/src/ValueObject/SendMessageBatchRequestEntry.php 2025-08-11 10:03:27.000000000 +0000 @@ -109,18 +109,30 @@ final class SendMessageBatchRequestEntry private $messageDeduplicationId; /** - * This parameter applies only to FIFO (first-in-first-out) queues. - * - * The tag that specifies that a message belongs to a specific message group. Messages that belong to the same message - * group are processed in a FIFO manner (however, messages in different message groups might be processed out of order). - * To interleave multiple ordered streams within a single queue, use `MessageGroupId` values (for example, session data - * for multiple users). In this scenario, multiple consumers can process the queue, but the session data of each user is - * processed in a FIFO fashion. - * - * - You must associate a non-empty `MessageGroupId` with a message. If you don't provide a `MessageGroupId`, the action - * fails. - * - `ReceiveMessage` might return messages with multiple `MessageGroupId` values. For each `MessageGroupId`, the - * messages are sorted by time sent. The caller can't specify a `MessageGroupId`. + * `MessageGroupId` is an attribute used in Amazon SQS FIFO (First-In-First-Out) and standard queues. In FIFO queues, + * `MessageGroupId` organizes messages into distinct groups. Messages within the same message group are always processed + * one at a time, in strict order, ensuring that no two messages from the same group are processed simultaneously. In + * standard queues, using `MessageGroupId` enables fair queues. It is used to identify the tenant a message belongs to, + * helping maintain consistent message dwell time across all tenants during noisy neighbor events. Unlike FIFO queues, + * messages with the same `MessageGroupId` can be processed in parallel, maintaining the high throughput of standard + * queues. + * + * - **FIFO queues:**`MessageGroupId` acts as the tag that specifies that a message belongs to a specific message group. + * Messages that belong to the same message group are processed in a FIFO manner (however, messages in different + * message groups might be processed out of order). To interleave multiple ordered streams within a single queue, use + * `MessageGroupId` values (for example, session data for multiple users). In this scenario, multiple consumers can + * process the queue, but the session data of each user is processed in a FIFO fashion. + * + * If you do not provide a `MessageGroupId` when sending a message to a FIFO queue, the action fails. + * + * `ReceiveMessage` might return messages with multiple `MessageGroupId` values. For each `MessageGroupId`, the + * messages are sorted by time sent. + * - **Standard queues:**Use `MessageGroupId` in standard queues to enable fair queues. The `MessageGroupId` identifies + * the tenant a message belongs to. A tenant can be any entity that shares a queue with others, such as your customer, + * a client application, or a request type. When one tenant sends a disproportionately large volume of messages or has + * messages that require longer processing time, fair queues ensure other tenants' messages maintain low dwell time. + * This preserves quality of service for all tenants while maintaining the scalability and throughput of standard + * queues. We recommend that you include a `MessageGroupId` in all messages when using fair queues. * * The length of `MessageGroupId` is 128 characters. Valid values: alphanumeric characters and punctuation * `(!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~)`. @@ -128,8 +140,6 @@ final class SendMessageBatchRequestEntry * For best practices of using `MessageGroupId`, see Using the MessageGroupId Property [^1] in the *Amazon SQS Developer * Guide*. * - * ! `MessageGroupId` is required for FIFO queues. You can't use it for Standard queues. - * * [^1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagegroupid-property.html * * @var string|null