async-aws/s3
S3 client, part of the AWS SDK provided by AsyncAws.
3.4.1
18M downloads/mo
#671 most downloaded on Packagist
async-aws/s3
What this package is like to depend on
Last release 25 days ago
29 Jul 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 41 of 41 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
41 releases · first in 2020
6 releases in the last 12 months
see the full history below
Release timeline
41 releases · Feb 2020 to Jul 2026
2021
2022
2023
2024
2025
2026
Releases
latest 41-
3.4.129 Jul 2026 -
3.4.001 Jul 2026Release notes
Open source →Added
- AWS api-change: Added support for annotations. You can now attach up to 1000 annotations (up to 1 MB each) directly to objects and create, retrieve, list, and delete them using new annotation APIs. Also added support for configuring an annotation table in S3 Metadata.
-
3.3.029 Apr 2026Release notes
Open source →Added
- AWS api-change: This release adds five additional checksum algorithms for S3 data integrity (MD5, SHA-512, XXHash3, XXHash64, XXHash128) and support for S3 Inventory on directory buckets (S3 Express One Zone).
-
3.2.018 Apr 2026Release notes
Open source →Added
- Added
S3Client::getBucketLifecycleConfiguration()andS3Client::putBucketLifecycleConfiguration()methods - AWS api-change: Adds support for account regional namespaces for general purpose buckets. The account regional namespace is a reserved subdivision of the global bucket namespace where only your account can create general purpose buckets.
- AWS api-change: Updated list of the valid AWS Region values for the LocationConstraint parameter for general purpose buckets.
Fixed
- SignerV4: Fix presign request for S3 when request contains user-defined metadata
- Added
-
3.1.016 Feb 2026Release notes
Open source →Added
- Added
S3Client::getBucketVersioning()andS3Client::putBucketVersioning()methods
Changed
- AWS enhancement: Documentation updates.
- Added
-
3.0.016 Jan 2026Release notes
Open source →BC-BREAK
- AWS api-change: Expires's property and its getters/setters switched from
\DateTimeImmutabletostring.
Added
- Add
UNKNOWN_TO_SDKvalue to enums that is used when the API returns an value that is not (or not yet) known by the AsyncAws - AWS api-change: Added
us-isob-west-1region - Added
S3Client::putPublicAccessBlock()method - AWS api-change: Amazon Simple Storage Service / Features: Add conditional writes in CopyObject on destination key to prevent unintended object modifications.
- AWS api-change: Adds support for blocking SSE-C writes to general purpose buckets.
- AWS api-change: New S3 Storage Class FSX_ONTAP
- AWS api-change: Added
eusc-de-east-1region
Dependency bumped
- Drop support for PHP versions lower than 8.2
Changed
- Apply new CodingStandard from latest php-cs-fixer.
- Harden code against error cases
- AWS enhancement: Documentation updates.
- Use a more stable sorting for the list of generated region metadata
- Remove unnecessary
usestatements - Fix PHP 8.5 deprecation warning for
DateTimeInterface::RFC7231
- AWS api-change: Expires's property and its getters/setters switched from
-
2.10.011 Aug 2025Release notes
Open source →Added
- AWS api-change: Rework regions configuration
- AWS api-change: Added
tagCountproperty to the HeadObject response - AWS api-change: Adds support for additional server-side encryption mode and storage class values for accessing Amazon FSx data from Amazon S3 using S3 Access Points
- AWS api-change: Added support for directory bucket creation with tags and bucket ARN retrieval in CreateBucket, ListDirectoryBuckets, and HeadBucket operations
-
2.9.103 Jun 2025 -
2.9.012 May 2025Release notes
Open source →Added
- AWS api-change: Added
eu-isoe-west-1region
Changed
- Normalize the composer requirements
- Sort exception alphabetically.
- AWS enhancement: Documentation updates.
- AWS api-change: Added
-
2.8.005 Mar 2025Release notes
Open source →Added
- AWS api-change: This change enhances integrity protections for new SDK requests to S3. S3 SDKs now support the CRC64NVME checksum algorithm, full object checksums for multipart S3 objects, and new default integrity protections for S3 requests.
- AWS api-change: Added
us-isof-east-1andus-isof-south-1regions - AWS api-change: Updated list of the valid AWS Region values for the LocationConstraint parameter for general purpose buckets.
- AWS api-change: Added support for Content-Range header in HeadObject response.
-
2.7.015 Jan 2025Release notes
Open source →Added
- AWS api-change: Amazon S3 introduces support for AWS Dedicated Local Zones
- AWS api-change: Added
ap-southeast-7region - AWS api-change: Added
mx-central-1region
Changed
- Avoid usage of
aliaswhen use statement refers to self - AWS enhancement: Documentation updates.
-
2.6.026 Nov 2024Release notes
Open source →Added
- AWS api-change: Amazon Simple Storage Service / Features: Add support for ETag based conditional writes in PutObject and CompleteMultiPartUpload APIs to prevent unintended object modifications.
-
2.5.024 Nov 2024Release notes
Open source →Added
- AWS api-change: Add support for the new optional bucket-region and prefix query parameters in the ListBuckets API. For ListBuckets requests that express pagination, Amazon S3 will now return both the bucket names and associated AWS regions in the response.
- AWS api-change: Add support for conditional deletes for the S3 DeleteObject and DeleteObjects APIs. Add support for write offset bytes option used to append to objects with the S3 PutObject API.
Changed
- use strict comparison
null !==instead of! - AWS enhancement: Documentation updates.
-
2.4.009 Oct 2024Release notes
Open source →Added
- AWS api-change: Amazon Simple Storage Service / Features : Adds support for pagination in the S3 ListBuckets API.
- AWS api-change: Amazon Simple Storage Service / Features : Add support for conditional writes for PutObject and CompleteMultipartUpload APIs.
- AWS api-change: Added
ap-southeast-5region
Changed
- Enable compiler optimization for the
sprintffunction. - AWS enhancement: Documentation updates.
-
2.3.003 Jul 2024Release notes
Open source →Added
- AWS api-change: Added response overrides to Head Object requests.
Fixed
- Exception NoSuchKeyException not fired for
HeadObjectrequest.
-
2.2.114 May 2024 -
2.2.009 Jan 2024Release notes
Open source →Added
- AWS api-change: Added
fips-us-iso-east-1region - AWS api-change: Added
ca-west-1andfips-ca-west-1regions
- AWS api-change: Added
-
2.1.013 Dec 2023Release notes
Open source →Added
- AWS api-change: This release adds a new field COMPLETED to the ReplicationStatus Enum. You can now use this field to validate the replication status of S3 objects using the AWS SDK.
- Added
S3Client::uploadPartCopy()method - AWS api-change: Adds support for S3 Express One Zone.
Changed
- Allow passing explicit null values for optional fields of input objects
- AWS enhancement: Documentation updates.
Fixed
- Fix the format of the
objectLockRetainUntilDatefield in requests
-
2.0.007 Aug 2023Release notes
Open source →BC-BREAK
- The type for
\AsyncAws\S3\Input\PutObjectRequest::getContentLengthand\AsyncAws\S3\Input\PutObjectRequest::setContentLengthusesintinstead ofstringto reflect the AWS type. - The type for
\AsyncAws\S3\Input\UploadPartRequest::getContentLengthand\AsyncAws\S3\Input\UploadPartRequest::setContentLengthusesintinstead ofstringto reflect the AWS type. - The return type for
\AsyncAws\S3\Result\GetObjectOutput::getContentLengthusesintinstead ofstringto reflect the AWS type. - The return type for
\AsyncAws\S3\Result\HeadObjectOutput::getContentLengthusesintinstead ofstringto reflect the AWS type. - The return type for
\AsyncAws\S3\ValueObject\AwsObject::getSizeusesintinstead ofstringto reflect the AWS type. - The return type for
\AsyncAws\S3\ValueObject\Part::getSizeusesintinstead ofstringto reflect the AWS type.
Added
- AWS api-change: The S3 LISTObjects, ListObjectsV2 and ListObjectVersions API now supports a new optional header x-amz-optional-object-attributes. If header contains RestoreStatus as the value, then S3 will include Glacier restore status i.e. isRestoreInProgress and RestoreExpiryDate in List response.
- AWS api-change: Added
ap-south-2andeu-south-2bucket location constraints. - AWS api-change: Add support for the
il-central-1region - Use int as the PHP representation of long fields in generated code
Changed
- Improve parameter type and return type in phpdoc
- The type for
-
1.14.020 Jun 2023Release notes
Open source →Added
- AWS api-change: Added
ap-southeast-4region. - AWS enhancement: Documentation updates.
- AWS api-change: Provides support for "Snow" Storage class.
- AWS api-change: Integrate double encryption feature to SDKs.
- AWS api-change: This release adds SDK support for request-payer request header and request-charged response header in the "GetBucketAccelerateConfiguration", "ListMultipartUploads", "ListObjects", "ListObjectsV2" and "ListObjectVersions" S3 APIs.
- AWS api-change: Added
-
1.13.030 Nov 2022Release notes
Open source →Added
- Added
me-central-1,ap-southeast-3,eu-central-2,eu-south-2andap-south-2regions
- Added
-
1.12.027 May 2022Release notes
Open source →Changed
- Set default value to
falsefor thesendChunkedBodyoption.
Fixed
- Format datetime with
RFC7231to provide a workaround for unsupportedRFC822format. - Broken path to host when operation's URL contains a query string.
- Set default value to
-
1.11.001 Mar 2022Release notes
Open source →Added
- AWS api-change: Added
ap-southeast-3region. - AWS enhancement: Documentation updates.
- AWS feature: Adds support for flexible checksums
- AWS api-change: This release adds support for new integrity checking capabilities in Amazon S3. You can choose from four supported checksum algorithms for data integrity checking on your upload and download requests. In addition, AWS SDK can automatically calculate a checksum as it streams data into S3
- AWS api-change: Added
-
1.10.020 Dec 2021Release notes
Open source →Added
- AWS api-change: used unique endpoint for
accesspoint-*regions - AWS api-change: Rework regions configuration.
- AWS api-change: Introduce Amazon S3 Glacier Instant Retrieval storage class and a new setting in S3 Object Ownership to disable ACLs for bucket and the objects in it.
- AWS api-change: Amazon S3 Event Notifications adds Amazon EventBridge as a destination and supports additional event types. The PutBucketNotificationConfiguration API can now skip validation of Amazon SQS, Amazon SNS and AWS Lambda destinations.
- AWS api-change: Introduce two new Filters to S3 Lifecycle configurations - ObjectSizeGreaterThan and ObjectSizeLessThan. Introduce a new way to trigger actions on noncurrent versions by providing the number of newer noncurrent versions along with noncurrent days.
- AWS api-change: used unique endpoint for
-
1.9.202 Oct 2021Release notes
Open source →Added
- AWS enhancement: Documentation updates for Amazon S3
- Fixed camelCased of Dom classes
-
1.9.128 Jun 2021Release notes
Open source →Fixed
- Fix issue when a request to upload a file is retried
- camelCased methods with paginator and waiter
- AWS enhancement: Documentation updates for Amazon S3
-
1.9.031 Mar 2021Release notes
Open source →Added
- AWS api-change: Adding ID element to the CORSRule schema
- AWS api-change: Adding many more regions
Changed
- AWS api-change: Reword docblocks
- AWS enhancement: Amazon S3 Documentation updates
- AWS api-change: Improve documentation
- AWS enhancement: Documentation updates for Amazon S3
Fixed
- Wrong custom encoding on chunked stream
-
1.8.001 Feb 2021Release notes
Open source →Added
- Changed case of object's properties to camelCase.
- Added documentation in class headers.
- Added
PutBucketCors,DeleteBucketCorsandGetBucketCorsmethods. - Added domain exceptions
-
1.7.016 Jan 2021Release notes
Open source →Added
- AWS api-change: S3 adds support for multiple-destination replication, option to sync replica modifications; S3 Bucket Keys to reduce cost of S3 SSE with AWS KMS
- AWS api-change: Format GetObject's Expires header to be an http-date instead of iso8601
- Added support for
sendChunkedBodyoption to enable/disabled chunked body.
-
1.6.021 Nov 2020Release notes
Open source →Added
- Added
S3Client::putBucketNotificationConfiguration() - AWS api-change: S3 Intelligent-Tiering adds support for Archive and Deep Archive Access tiers
Changed
- Removed deprecation warning on Content-MD5 headers.
Fixed
- Make sure we throw exception from async-aws/core
- Added
-
1.5.119 Oct 2020Release notes
Open source →Fixed
- Fixed endpoint issue when a bucket name started with a number.
- Improve StorageClass documentation.
-
1.5.001 Oct 2020Release notes
Open source →Added
- AWS api-change: Amazon S3 on Outposts expands object storage to on-premises AWS Outposts environments, enabling you to store and retrieve objects using S3 APIs and features.
-
1.4.018 Sep 2020Release notes
Open source →Added
- AWS api-change: Bucket owner verification feature added. This feature introduces the x-amz-expected-bucket-owner and x-amz-source-expected-bucket-owner headers.
-
1.3.020 Aug 2020Release notes
Open source →Added
- Support for PHP 8
- Added
S3Client::deleteBucket()
Deprecated
PutObjectAclRequest::getContentMD5()PutObjectAclRequest::setContentMD5()
Fixed
- Fixed an issue in Metadata not being sent to AWS in
PutObject,CopyObjectandCreateMultipartUpload - Internal AWS prefix were added to Metadata's name in
GetObjectandHeadObject.
-
1.2.021 May 2020Release notes
Open source →Added
- Changed from "path style" endpoints (https://amazon.com/bucket) to "host style" endpoints (https://bucket.amazon.com). To keep the old behavior, use
s3PathStyleEndpoint: trueconfiguration option.
Deprecated
- Protected methods
getServiceCode,getSignatureVersionandgetSignatureScopeNameofS3Clientare deprecated and will be removed in 2.0
Fixed
- Fixed issue when Bucket or Object's Key contained a special char like
#
- Changed from "path style" endpoints (https://amazon.com/bucket) to "host style" endpoints (https://bucket.amazon.com). To keep the old behavior, use
-
1.1.007 May 2020Release notes
Open source →Added
- Backported split request behavior in
SignerV4ForS3
Fixed
- Add return typehint for
listMultipartUploads,listObjectsV2andlistParts
- Backported split request behavior in
-
1.0.003 May 2020 -
0.4.004 Apr 2020Release notes
Open source →Removed
- Dependency on
symfony/http-client-contracts - All
validate()methods on the inputs. They are merged withrequest().
Added
- Support for presign
- Multipart upload
- Waiters:
S3Client::bucketExists()andS3Client::objectExists() - The
AsyncAws\S3\Enum\*,AsyncAws\S3\Input\*andAsyncAws\S3\ValueObject*classes are marked final.
Changed
- Moved value objects to a dedicated namespace.
- Results'
populateResult()has only one argument. It takes aAsyncAws\Core\Response. - Using
DateTimeImmutableinstead ofDateTimeInterface
- Dependency on
-
0.3.014 Mar 2020Release notes
Open source →Added
- Enums;
BucketCannedACL,BucketLocationConstraint,EncodingType,MetadataDirective,ObjectCannedACL,ObjectLockLegalHoldStatusObjectLockMode,ObjectStorageClass,Permission,ReplicationStatus,RequestCharged,RequestPayer,ServerSideEncryptionStorageClass,TaggingDirective,Type
Changed
- Removed
requestBody(),requestHeaders(),requestQuery()andrequestUri()input classes. They are replaced withrequest(). - Using async-aws/core: 0.4.0
Fixed
- Dont generate a request body when no body is needed.
- Enums;
-
0.2.029 Feb 2020 -
0.1.022 Feb 2020