PackageTrack
Sign in Get early access

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
Release Pre-release

Releases

latest 60 of 257
  1. 3.35.3 22 Aug 2026
    Release notes
    • [Filesystem] Report broken utf-8 as corrupted path
    Open source →
  2. 3.35.2 06 Jul 2026
    Release notes
    • [AwsS3V3] Let ACL config take precedence over visibility during copy (#1905)
    Open source →
  3. 3.35.1 25 Jun 2026
    Release notes
    • [AwsS3V3] Remove lock file from artefact.
    Open source →
  4. 3.35.0 22 Jun 2026
    Release notes
    • [Filesystem] Guard against null mime-type return at Filesystem level (#1901)
    Open source →
  5. 3.34.0 14 May 2026
    Release notes

    Added

    • [Filesystem] Add ability to disable relative path resolution inside the configured root path.
    Open source →
  6. 3.33.0 25 Mar 2026
    Release notes

    Changes

    • [SFTP V3] Add support for multiple fingerprints (#1893)
    Open source →
  7. 3.32.0 25 Feb 2026
    Release notes

    Changes

    • [AwsS3V3] Allow SSE-C options when fetching file metadata
    Open source →
  8. 3.31.0 23 Jan 2026
    Release notes

    Changes

    • [AsyncAwsS3] Allow V3
    Open source →
  9. 3.30.2 10 Nov 2025
    Release notes

    Fixes

    • [Local] Clear last error for rename and copy operations (#1883)
    Open source →
  10. 3.30.1 20 Oct 2025
    Release notes

    Fixes

    • Ensure listing directories called "0" do not produce unfiltered listings.
    Open source →
  11. 3.30.0 25 Jun 2025
    Release notes

    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.
    Open source →
  12. 3.29.1 08 Oct 2024
    Release notes

    Fixes

    • Normalise path for checksum call
    Open source →
  13. 3.29.0 29 Sep 2024
    Release notes

    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
    Open source →
  14. 3.28.0 22 May 2024
    Release notes

    Added

    • MongoDB GridFS adapter (by @GromNaN)

    Fixed

    • PHP 8.3 directory listing issue for the FTP adapter (by @lanz1)
    Open source →
  15. 3.27.0 07 Apr 2024
    Release notes

    Fixed

    • Corrected AWS SSE-C Options
    • Handle MetadataDirective gracefully.
    Open source →
  16. 3.26.0 25 Mar 2024
    Release notes

    Fixed

    • Make SFTP connectivity pinging an opt-in feature.

    Added

    • Add add_content_md5 option to AWS S3 (#1774)
    • Added AWS SSE-C options (#1773)
    Open source →
  17. 3.25.1 16 Mar 2024
    Release notes

    Fixed

    • Cleanup connection instance after disconnecting SFTP connection.
    • Fix upcoming PHP 8.4 deprecations (#1772)
    Open source →
  18. 3.25.0 09 Mar 2024
    Release notes

    Added

    • [MountManager] added ability to (dangerously) mount additional filesystems
    • [FTP] added disconnect method to proactively close connections
    • [SFTP V3] added disconnect method to proactively close connections
    Open source →
  19. 3.24.0 04 Feb 2024
    Release notes

    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))
    Open source →
  20. 3.23.1 26 Jan 2024
    Release notes

    Changes

    • Updated license year
    Open source →
  21. 3.23.0 04 Dec 2023
    Release notes

    Fixed

    • Fixed upstream regression caused by resolving inconclusive mime-type.

    Added

    • Made inconclusive mime-type resolving configurable on the local adapter.
    Open source →
  22. 3.22.0 03 Dec 2023
    Release notes

    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
    Open source →
  23. 3.21.0 18 Nov 2023
    Release notes

    Changes

    • Retain visibility on local copy for local FS, in line with other adapter (#1730) by @jnoordsij
    Open source →
  24. 3.20.0 14 Nov 2023
    Release notes

    Changed

    • Normalise paths for public and temporary URLs (#1727)
    Open source →
  25. 3.19.0 07 Nov 2023
    Release notes

    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.
    Open source →
  26. 3.18.0 20 Oct 2023
    Release notes

    Added

    • Configuration option to specify how to handle same path copy/move operations (#1715)
    Open source →
  27. 3.17.0 05 Oct 2023
    Release notes

    Added

    • [AsyncAWS] Added support for version 2.0 of async-aws/{s3,simple-s3}
    Open source →
  28. 3.16.0 07 Sep 2023
    Release notes

    Added

    • [AsyncAws] Allow specifying get_object_options for temporary URL generation

    Fixed

    • [ZipArchive] override on move
    • [WebDAV] encode path for propfind actions
    • [PathPrefixing] #1686
    Open source →
  29. 3.15.1 04 May 2023
    Release notes

    Fixed

    • Remove duplicate class caused by package extractin and inclusion
    Open source →
  30. 3.15.0 04 May 2023
    Release notes

    Added

    • Extracted the local adapter as a standalone package

    Changed

    • Removed readme's from shipped artefacts.
    Open source →
  31. 3.14.0 11 Apr 2023
    Release notes

    Added

    • Made disabling stat cache configurable for SFTP adapters.
    Open source →
  32. 3.13.0 11 Apr 2023
    Release notes

    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
    Open source →
  33. 3.12.3 18 Feb 2023
    Release notes

    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
    Open source →
  34. 3.12.2 19 Jan 2023

    Nothing published for this version

  35. 3.12.1 06 Jan 2023
    Release notes

    Fixed

    • [AWS S3] Use doesObjectExistV2 to prevent false positive respomnses.
    Open source →
  36. 3.12.0 20 Dec 2022
    Release notes

    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.
    Open source →
  37. 3.11.0 02 Dec 2022
    Release notes

    Added

    • [Google Cloud Storage] Added UniformBucketLevelAccessVisibility to allow buckets with uniform bucket-level access policies.
    Open source →
  38. 3.10.4 26 Nov 2022
    Release notes

    Changed

    Fixed

    • [PathPrefixing] ensure checksum and temporaryUrl are prefixed
    • [WebDAV] ensure directory creation uses trailing slashes for paths
    Open source →
  39. 3.10.3 14 Nov 2022
    Release notes

    Fixed

    • [Local] Handle checksum errors without message (#1590)
    Open source →
  40. 3.10.2 25 Oct 2022
    Release notes

    Fixed

    • [Filesystem] Ensure adapter is used for exposing temporary URLs.
    Open source →
  41. 3.10.1 21 Oct 2022
    Release notes

    Fixed

    • [Filesystem] Added missing constructor argument to allow temporary URL generator injection.
    Open source →
  42. 3.10.0 21 Oct 2022
    Release notes

    Added

    • [Filesystem] added temporaryUrl method
    • [AsyncAWS] added temporaryUrl method
    • [AWS S3] added temporaryUrl method
    • [Azure Blob Storage] added temporaryUrl method
    • [MountManager] added temporaryUrl method
    • [Google Cloud Storage] added temporaryUrl method
    • [ReadOnly] added temporaryUrl method
    • [PathPrefixing] added temporaryUrl method
    Open source →
  43. 3.9.0 18 Oct 2022
    Release notes

    Added

    • [Filesystem] Added ability to inject custom public URL generator into a filesystem.
    • [MountManager] added checksum and publicUrl methods
    • [ZipArchive] Do not prefix directories when creating/reading an archive
    • [ShardedPrefixPublicUrlGenerator] added url generator strategy that distributes over a list of prefixes
    Open source →
  44. 3.8.0 18 Oct 2022
    Release notes

    Added

    • [ChecksumAlgoIsNotSupported] Exception to indicate a checksum is not supported by the checksum provider, filesystem will fall back to ad-hoc generation.
    Open source →
  45. 3.7.0 17 Oct 2022
    Release notes

    Added

    • [Filesystem] added checksum method
    • [AWS S3] added checksum method
    • [Async S3] added checksum method
    • [Google Cloud Storage] added checksum method
    • [Azure Blob Storage] added checksum method
    Open source →
  46. 3.6.0 13 Oct 2022
    Release notes

    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
    Open source →
  47. 3.5.2 23 Sep 2022
    Release notes

    Fixed

    • [SFTP v2/v3] Fixed possible race-condition during directory creation leading to false failures.
    Open source →
  48. 3.5.1 18 Sep 2022
    Release notes

    Fixed

    • [WebDAV] Strip directory prefix in createDirectory to prevent double prefixing in directoryExists.
    Open source →
  49. 3.5.0 17 Sep 2022
    Release notes

    Added

    • [AWS S3] Allow specifying visibility on move and copy
    Open source →
  50. 3.4.0 16 Sep 2022
    Release notes

    Added

    • Added FTP configuration option useRawListOptions (null|false|true).
    • UnableToListContents exception was added to uniformly represent content listing exceptions.

    Fixed

    • [FTP] Don't use raw list options for FileZilla FTP servers (#1553)
    • [WebDAV] Correct path formatting for move and copy operations (#1552)
    Open source →
  51. 3.3.0 09 Sep 2022
    Release notes

    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)
    Open source →
  52. 3.2.1 14 Aug 2022
    Release notes

    Fixed

    • [ZipArchive] reverted regression introduced in #1525
    Open source →
  53. 3.2.0 26 Jul 2022
    Release notes

    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 ChecksumAlgorithm to forwarded options.
    • [AwsS3V3] add ContentMD5 to forwarded options.
    • [AwsS3V3] made forwarded options and metadata fields configurable.
    • [SftpV3] upgrade minimum version, PHP 8 and the lowest version fails to authenticate.
    Open source →
  54. 3.1.1 18 Jul 2022
    Release notes
    • [AwsS3V3] Corrected exception type (#1524)
    Open source →
  55. 3.1.0 29 Jun 2022
    Release notes
    • Added option for the Local adapter to create the root directory only on the first mutating (write/copy/move) action.
    Open source →
  56. 3.0.23 29 Jun 2022
    Release notes
    • Added reasons for exceptions for all adapters that were missing previous exception messages.
    Open source →
  57. 3.0.22 29 Jun 2022
    Release notes
    • [AwsS3V3] Added reasons for exceptions
    • [AwsS3V3] Use ListObjectsV2 instead of ListObjects
    Open source →
  58. 3.0.21 12 Jun 2022
    Release notes
    • [AwsS3V3] Use ListObjectsV2 instead of ListObjects
    Open source →
  59. 3.0.20 25 May 2022
    Release notes

    Fixed

    • [Core] Fix deprecated ${var} string interpolation patterns (#1470)
    Open source →
  60. 3.0.19 03 May 2022
    Release notes

    Fixed

    • [FTP] Turn errors into proper exceptions when resolving the connection root (#1460)
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive