league/flysystem
File storage abstraction for PHP
3.35.3
706M downloads/mo
#72 most downloaded on composer
thephpleague/flysystem
What this package is like to depend on
Last release today
22 Aug 2026
Release timing varies
gaps range from 8 days to 9 months
Some releases are documented
notes for 103 of 248 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
257 releases · first in 2013
10 releases in the last 12 months
see the full history below
Release timeline
257 releases · Oct 2013 to Aug 2026
2014
2016
2018
2020
2022
2024
2026
Releases
latest 60 of 257-
3.35.322 Aug 2026 -
3.35.206 Jul 2026Release notes
Open source →- [AwsS3V3] Let ACL config take precedence over visibility during copy (#1905)
-
3.35.125 Jun 2026 -
3.35.022 Jun 2026Release notes
Open source →- [Filesystem] Guard against null mime-type return at Filesystem level (#1901)
-
3.34.014 May 2026Release notes
Open source →Added
- [Filesystem] Add ability to disable relative path resolution inside the configured root path.
-
3.33.025 Mar 2026 -
3.32.025 Feb 2026 -
3.31.023 Jan 2026 -
3.30.210 Nov 2025 -
3.30.120 Oct 2025Release notes
Open source →Fixes
- Ensure listing directories called "0" do not produce unfiltered listings.
-
3.30.025 Jun 2025Release notes
Open source →Changes
- [MongoDB] Allow v2
- [AsyncAWS] Encode/decode object identifiers
- [GoogleCloudStorage] Add option to stream responses
- [Local] Clear stat cache consistently
- [SFTP] Add option to disconnect connections on destruction
- [WebDAV] Deal with 405 case when trying to create a directory that already exists.
-
3.29.108 Oct 2024 -
3.29.029 Sep 2024Release notes
Open source →Changes
- [FTP] Add error context from error messages
- [SFTP] overwrite on move
- [AWS S3] same path copy/move no-op
- [Async S3] transform error to flysystem errors
-
3.28.022 May 2024Release notes
Open source →Added
- MongoDB GridFS adapter (by @GromNaN)
Fixed
- PHP 8.3 directory listing issue for the FTP adapter (by @lanz1)
-
3.27.007 Apr 2024 -
3.26.025 Mar 2024Release notes
Open source →Fixed
- Make SFTP connectivity pinging an opt-in feature.
Added
- Add
add_content_md5option to AWS S3 (#1774) - Added AWS SSE-C options (#1773)
-
3.25.116 Mar 2024Release notes
Open source →Fixed
- Cleanup connection instance after disconnecting SFTP connection.
- Fix upcoming PHP 8.4 deprecations (#1772)
-
3.25.009 Mar 2024Release notes
Open source →Added
- [MountManager] added ability to (dangerously) mount additional filesystems
- [FTP] added
disconnectmethod to proactively close connections - [SFTP V3] added
disconnectmethod to proactively close connections
-
3.24.004 Feb 2024Release notes
Open source →Fixes
- Updated method signatures to match upgraded dependency signatures for overrides (#1748, #1746)
- Added missing path prefixing in FTP implementation (#1747)
Changes
- Updated string assertions to use PHP 8 functions (#1750, #1749))
-
3.23.126 Jan 2024 -
3.23.004 Dec 2023Release notes
Open source →Fixed
- Fixed upstream regression caused by resolving inconclusive mime-type.
Added
- Made inconclusive mime-type resolving configurable on the local adapter.
-
3.22.003 Dec 2023Release notes
Open source →Changes
- Prevent double directory creation with lazy root creation for Local filesystem.
Fixes
- Resolve to "inconclusive" mimetype instead of causing a type error by @GuySartorelli
- Corrected spelling of a configuration key for the Azure adapter by @shineability
Additions
- MountManager::extend allows for immutable dynamic extension of the mount manager.
- Added a new abstract DecoratedAdapter for easier decoration of adapters by @jnoordsij
-
3.21.018 Nov 2023Release notes
Open source →Changes
- Retain visibility on local copy for local FS, in line with other adapter (#1730) by @jnoordsij
-
3.20.014 Nov 2023 -
3.19.007 Nov 2023Release notes
Open source →Added
- Configuration option to specify if visibility should be retained during copy/move operations
- InMemoryFilesystemAdapter now supports visibility changes on move and copy.
- Default visibility options are ignored when moving/copying while respecting visibility retention settings.
- Local filesystem implementation now allows setting visibility on move and copy.
-
3.18.020 Oct 2023Release notes
Open source →Added
- Configuration option to specify how to handle same path copy/move operations (#1715)
-
3.17.005 Oct 2023Release notes
Open source →Added
- [AsyncAWS] Added support for version 2.0 of async-aws/{s3,simple-s3}
-
3.16.007 Sep 2023Release notes
Open source →Added
- [AsyncAws] Allow specifying
get_object_optionsfor temporary URL generation
Fixed
- [ZipArchive] override on move
- [WebDAV] encode path for propfind actions
- [PathPrefixing] #1686
- [AsyncAws] Allow specifying
-
3.15.104 May 2023 -
3.15.004 May 2023Release notes
Open source →Added
- Extracted the local adapter as a standalone package
Changed
- Removed readme's from shipped artefacts.
-
3.14.011 Apr 2023 -
3.13.011 Apr 2023Release notes
Open source →Fixed
- AsyncAwsS3 object deletion now chunks per 100 objects to prevent memory exhaustion
- AsyncAwsS3 now disregards top-level directories from listings
- LocalAdapter now deals with file deletions during directory listings gracefully.
Added
- DirectoryListing now supports correct phpstan for map and filter methods.
- FTP/SFTP added config option to detect the mime-type using the path alone (prevents a read)
- SFTP now supports PuTTY style private keys
-
3.12.318 Feb 2023Release notes
Open source →Fixed
- [Google Cloud Storage] Fixed ACL error for uniform bucker ACL copy operations.
-
3.12.2 - 2023-01-19
Fixed
- [AWS S3] Corrected param order for doesObjectExistV2 call
-
3.12.219 Jan 2023Nothing published for this version
-
3.12.106 Jan 2023Release notes
Open source →Fixed
- [AWS S3] Use doesObjectExistV2 to prevent false positive respomnses.
-
3.12.020 Dec 2022Release notes
Open source →Added
- [Core] Chained public URL generation strategy
Fixed
- [WebDAV] Handle cases where the content listing returns entries with URL prefixes.
- [Local] Ensure correct implicit root creations happens on windows.
- [ZipArchive] Fix incorrect zip contents listing for top-level directory.
-
3.11.002 Dec 2022Release notes
Open source →Added
- [Google Cloud Storage] Added
UniformBucketLevelAccessVisibilityto allow buckets with uniform bucket-level access policies.
- [Google Cloud Storage] Added
-
3.10.426 Nov 2022Release notes
Open source →Changed
Fixed
- [PathPrefixing] ensure
checksumandtemporaryUrlare prefixed - [WebDAV] ensure directory creation uses trailing slashes for paths
- [PathPrefixing] ensure
-
3.10.314 Nov 2022 -
3.10.225 Oct 2022 -
3.10.121 Oct 2022Release notes
Open source →Fixed
- [Filesystem] Added missing constructor argument to allow temporary URL generator injection.
-
3.10.021 Oct 2022Release notes
Open source →Added
- [Filesystem] added
temporaryUrlmethod - [AsyncAWS] added
temporaryUrlmethod - [AWS S3] added
temporaryUrlmethod - [Azure Blob Storage] added
temporaryUrlmethod - [MountManager] added
temporaryUrlmethod - [Google Cloud Storage] added
temporaryUrlmethod - [ReadOnly] added
temporaryUrlmethod - [PathPrefixing] added
temporaryUrlmethod
- [Filesystem] added
-
3.9.018 Oct 2022Release notes
Open source →Added
- [Filesystem] Added ability to inject custom public URL generator into a filesystem.
- [MountManager] added
checksumandpublicUrlmethods - [ZipArchive] Do not prefix directories when creating/reading an archive
- [ShardedPrefixPublicUrlGenerator] added url generator strategy that distributes over a list of prefixes
-
3.8.018 Oct 2022Release notes
Open source →Added
- [ChecksumAlgoIsNotSupported] Exception to indicate a checksum is not supported by the checksum provider, filesystem will fall back to ad-hoc generation.
-
3.7.017 Oct 2022Release notes
Open source →Added
- [Filesystem] added
checksummethod - [AWS S3] added
checksummethod - [Async S3] added
checksummethod - [Google Cloud Storage] added
checksummethod - [Azure Blob Storage] added
checksummethod
- [Filesystem] added
-
3.6.013 Oct 2022Release notes
Open source →Added
- [Filesystem] Added public url method
- [Azure Blob Storage] Added public url method
- [AWS S3] Added public url method
- [Async S3] Added public url method
- [GCS] Added public url method
- [WebDAV] Added public url method
- [ReadOnly] Added public url method
- [PathPrefixing] Added public url method
-
3.5.223 Sep 2022Release notes
Open source →Fixed
- [SFTP v2/v3] Fixed possible race-condition during directory creation leading to false failures.
-
3.5.118 Sep 2022Release notes
Open source →Fixed
- [WebDAV] Strip directory prefix in
createDirectoryto prevent double prefixing indirectoryExists.
- [WebDAV] Strip directory prefix in
-
3.5.017 Sep 2022 -
3.4.016 Sep 2022Release notes
Open source →Added
- Added FTP configuration option useRawListOptions (null|false|true).
- UnableToListContents exception was added to uniformly represent content listing exceptions.
Fixed
-
3.3.009 Sep 2022Release notes
Open source →Added
- StaticInMemoryAdapterRegistry contributed by @kbond
- ReadonlyFilesystemAdapter contributed by @kbond
- PathPrefixedAdapter contributed by @shyim
Fixed
- WebDAV prefix is now encoded and the dir is not required to be pre-created (#1533)
-
3.2.114 Aug 2022 -
3.2.026 Jul 2022Release notes
Open source →Added
- [AwsS3V3] Added configuration options for forwarded options, multipart upload configuration, and metadata fields.
Fixes
- [ZipArchive] delete top-level directory when deleting directories.
- [AwsS3V3] add
ChecksumAlgorithmto forwarded options. - [AwsS3V3] add
ContentMD5to forwarded options. - [AwsS3V3] made forwarded options and metadata fields configurable.
- [SftpV3] upgrade minimum version, PHP 8 and the lowest version fails to authenticate.
-
3.1.118 Jul 2022 -
3.1.029 Jun 2022Release notes
Open source →- Added option for the Local adapter to create the root directory only on the first mutating (write/copy/move) action.
-
3.0.2329 Jun 2022Release notes
Open source →- Added reasons for exceptions for all adapters that were missing previous exception messages.
-
3.0.2229 Jun 2022Release notes
Open source →- [AwsS3V3] Added reasons for exceptions
- [AwsS3V3] Use ListObjectsV2 instead of ListObjects
-
3.0.2112 Jun 2022 -
3.0.2025 May 2022Release notes
Open source →Fixed
- [Core] Fix deprecated ${var} string interpolation patterns (#1470)
-
3.0.1903 May 2022Release notes
Open source →Fixed
- [FTP] Turn errors into proper exceptions when resolving the connection root (#1460)