league/flysystem

File storage abstraction for PHP

3.34.0 2026-05-14 10:28 UTC

Requires

• php: ^8.0.2
• league/flysystem-local: ^3.0.0
• league/mime-type-detection: ^1.0.0

Requires (Dev)

• ext-fileinfo: *
• ext-ftp: *
• ext-mongodb: ^1.3|^2
• ext-zip: *
• async-aws/s3: ^1.5 || ^2.0
• async-aws/simple-s3: ^1.1 || ^2.0
• aws/aws-sdk-php: ^3.295.10
• composer/semver: ^3.0
• friendsofphp/php-cs-fixer: ^3.5
• google/cloud-storage: ^1.23
• guzzlehttp/psr7: ^2.6
• microsoft/azure-storage-blob: ^1.1
• mongodb/mongodb: ^1.2|^2
• phpseclib/phpseclib: ^3.0.36
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^9.5.11|^10.0
• sabre/dav: ^4.6.0

Conflicts

• async-aws/core: <1.19.0
• async-aws/s3: <1.14.0
• aws/aws-sdk-php: 3.209.31 || 3.210.0
• guzzlehttp/guzzle: <7.0
• guzzlehttp/ringphp: <1.1.1
• phpseclib/phpseclib: 3.0.15
• symfony/http-client: <5.2

MIT

• Frank de Jonge

• file
• filesystem
• storage
• s3
• WebDAV
• cloud
• aws
• files
• sftp
• ftp
• filesystems

README

About Flysystem

Flysystem is a file storage library for PHP. It provides one interface to interact with many types of filesystems. When you use Flysystem, you're not only protected from vendor lock-in, you'll also have a consistent experience for which ever storage is right for you.

Getting Started

• New in V3: What is new in Flysystem V2/V3?
• Architecture: Flysystem's internal architecture
• Flysystem API: How to interact with your Flysystem instance
• Upgrade from 1x: How to upgrade from 1.x/2.x

Officially supported adapters

• Local
• FTP
• SFTP
• Memory
• AWS S3
• AsyncAws S3
• Google Cloud Storage
• MongoDB GridFS
• WebDAV
• ZipArchive

Third party Adapters

• Azure Blob Storage
• Gitlab
• Google Drive (using regular paths)
• bunny.net / BunnyCDN
• Sharepoint 365 / One Drive (Using MS Graph)
• OneDrive
• Dropbox
• ReplicateAdapter
• Uploadcare
• Useful adapters (FallbackAdapter, LogAdapter, ReadWriteAdapter, RetryAdapter)
• Metadata Cache
• Migration adapter (lazy)

You can always create an adapter yourself.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Enjoy

Oh, and if you've come down this far, you might as well follow me on twitter.