azure-oss/storage-blob
Azure Blob Storage PHP SDK
2.3.0
68K downloads/mo
#3387 most downloaded on Packagist
php-oss-for-azure/azure-storage-blob-php
What this package is like to depend on
Last release 3 days ago
20 Aug 2026
Release timing varies
gaps range from 2 weeks to 7 months
Some releases are documented
notes for 9 of 17 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
17 releases · first in 2024
12 releases in the last 12 months
see the full history below
Release timeline
17 releases · Jul 2024 to Aug 2026Releases
latest 17-
2.3.020 Aug 2026Release notes
Open source →Changed
- Added support for Guzzle 8 while retaining Guzzle 7 support.
- Lease break requests now send their optional break period as an HTTP header string, as required by Guzzle 8.
- Async operations now declare their resolved promise result types for static analysis and IDEs.
Release notes
Open source →Changed
- Added support for Guzzle 8 while retaining Guzzle 7 support.
- Lease break requests now send their optional break period as an HTTP header string, as required by Guzzle 8.
- Async operations now declare their resolved promise result types for static analysis and IDEs.
-
2.2.230 Jun 2026Release notes
Open source →Changed
- Blob SAS generation now uses the shared storage-common date helper for SAS timestamp formatting.
Release notes
Open source →Changed
- Blob SAS generation now uses the shared storage-common date helper for SAS timestamp formatting.
-
2.2.129 Jun 2026Release notes
Open source →Changed
- Blob and container SAS generation now sign against a cloned
BlobSasBuilder, preventing blob-specific state from leaking into later container SAS calls when the same builder instance is reused. BlobSasBuilder::build()now validates required fields and throwsUnableToGenerateSasExceptioninstead of surfacing raw typed-property initialization errors.
- Blob and container SAS generation now sign against a cloned
-
2.2.028 Jun 2026Release notes
Open source →Added
- Added
BlobIncludeand support for requesting snapshots, metadata, uncommitted blobs, copy information, deleted blobs, tags, versions, and deleted blobs with versions fromBlobContainerClient::getBlobs()andgetBlobsByHierarchy(). - Added list-response snapshot, metadata, tags, version, and deletion state to
Blob. - Added
BlobClient::undelete()andundeleteAsync()for restoring soft-deleted blobs, snapshots, and versions. - Added
DeleteSnapshotsOptionsupport for deleting a blob together with its snapshots or deleting only its snapshots. - Added deletion time and remaining retention days to listed blob properties.
- Added deleted-container listing and restoration through
GetBlobContainersOptions,BlobContainerInclude, andBlobServiceClient::undeleteBlobContainer(). - Added container deletion state, deleted version, deletion time, remaining retention days, and requested metadata to container list results.
- Added blob snapshot creation through
BlobClient::createSnapshot()andcreateSnapshotAsync(), configured withCreateSnapshotOptions. - Added
BlobClient::withSnapshot(),BlobClient::withVersion(), and matching block blob methods for targeting immutable snapshots and versions. - Added snapshot- and version-specific blob SAS generation with the correct
bsandbvsigned resources. - Added version identifiers to blob properties and copy results, plus current-version state to blob properties.
- Added
-
2.1.027 Jun 2026Release notes
Open source →Changes since
2.0.1.Added
- Added blob and container lease support through
BlobLeaseClient, with synchronous and asynchronous acquire, renew, change, release, and break operations. - Added conditional blob requests using ETag, date, and lease ID conditions. Conditions are supported by uploads, downloads, property and metadata operations, tag operations, deletes, block staging and commits, copies, and lease operations where Azure permits them.
- Added per-client Storage API version selection to blob service, container, blob, block blob, and lease client options. The selected version is propagated to clients created from a parent client.
- Added ETags to
BlobPropertiesandBlobContainerProperties. - Added
TagsTooLargetoBlobErrorCode.
Changed
- Blob and account SAS tokens now default to the latest generally available Storage API version.
- Container property requests now use the Azure
HEADoperation.
- Added blob and container lease support through
-
2.0.126 Jun 2026Release notes
Open source →Please review the upgrade guides before updating to the latest version:
https://github.com/Azure-OSS/azure-storage-blob-php/blob/main/UPGRADE.md
https://github.com/Azure-OSS/azure-storage-common-php/blob/main/UPGRADE.mdFull Changelog: 2.0.0...2.0.1
-
1.9.015 Mar 2026Nothing published for this version
-
1.8.005 Mar 2026 -
1.7.001 Mar 2026 -
1.6.017 Nov 2025 -
1.5.030 Sep 2025Nothing published for this version
-
1.4.005 Sep 2025Nothing published for this version
-
1.3.107 Feb 2025Nothing published for this version
-
1.3.010 Nov 2024Nothing published for this version
-
1.2.006 Aug 2024Nothing published for this version
-
1.1.010 Jul 2024Nothing published for this version
-
1.0.006 Jul 2024Nothing published for this version