rossriley/flysystem53

Many filesystems, one API. - This fork maintains PHP 5.3 compatibility while tracking upstream

1.1.5 2015-02-16 10:45 UTC

Requires

• php: >=5.3.0

Requires (Dev)

• ext-fileinfo: *
• league/phpunit-coverage-listener: ~1.1
• mockery/mockery: ~0.9
• phpspec/phpspec: ~2.0.0
• phpspec/prophecy-phpunit: ~1.0
• phpunit/phpunit: ~4.0
• predis/predis: ~1.0
• tedivm/stash: ~0.12.0

Suggests

• ext-fileinfo: Required for MimeType
• league/flysystem-aws-s3-v2: Use S3 storage with AWS SDK v2
• league/flysystem-aws-s3-v3: Use S3 storage with AWS SDK v3
• league/flysystem-azure: Allows you to use Windows Azure Blob storage
• league/flysystem-cached-adapter: Flysystem adapter decorator for metadata caching
• league/flysystem-copy: Allows you to use Copy.com storage
• league/flysystem-dropbox: Use Dropbox storage
• league/flysystem-eventable-filesystem: Allows you to use EventableFilesystem
• league/flysystem-rackspace: Allows you to use Rackspace Cloud Files
• league/flysystem-sftp: Allows SFTP server storage via phpseclib
• league/flysystem-webdav: Allows you to use WebDAV storage
• league/flysystem-ziparchive: Allows you to use ZipArchive adapter
• predis/predis: Allows you to use Predis for caching

Replaces

• league/flysystem: ~1.1

MIT

• Frank de Jonge

• filesystem
• storage
• s3
• WebDAV
• cloud
• aws
• remote
• files
• sftp
• rackspace
• ftp
• Cloud Files
• dropbox
• file systems
• copy.com

README

Flysystem is a filesystem abstraction which allows you to easily swap out a local filesystem for a remote one.

Goals

• Have a generic API for handling common tasks across multiple file storage engines.
• Have consistent output which you can rely on.
• Integrate well with other packages/frameworks.
• Be cacheable.
• Emulate directories in systems that support none, like AwsS3.
• Support third party plugins.
• Make it easy to test your filesystem interactions.
• Support streams for big file handling

Installation

Through Composer, obviously:

composer require league/flysystem

You can also use Flysystem without using Composer by registering an autoloader function:

spl_autoload_register(function($class) {
    $prefix = 'League\\Flysystem\\';

    if ( ! substr($class, 0, 17) === $prefix) {
        return;
    }

    $class = substr($class, strlen($prefix));
    $location = __DIR__ . 'path/to/flysystem/src/' . str_replace('\\', '/', $class) . '.php';

    if (is_file($location)) {
        require_once($location);
    }
});

Integrations

Want to get started quickly? Check out some of these integrations:

• Laravel integration: https://github.com/GrahamCampbell/Laravel-Flysystem
• Symfony integration: https://github.com/1up-lab/OneupFlysystemBundle
• Zend Framework integration: https://github.com/bushbaby/BsbFlysystem
• CakePHP integration: https://github.com/WyriHaximus/FlyPie
• Silex integration: https://github.com/WyriHaximus/SliFly
• Yii 2 integration: https://github.com/creocoder/yii2-flysystem
• Backup manager: https://github.com/heybigname/backup-manager

Adapters

• Local
• Amazon Web Services - S3: https://github.com/thephpleague/flysystem-aws-s3-v2
• Rackspace Cloud Files: https://github.com/thephpleague/flysystem-rackspace
• Dropbox: https://github.com/thephpleague/flysystem-dropbox
• Copy: https://github.com/thephpleague/flysystem-copy
• Ftp
• Sftp (through phpseclib): https://github.com/thephpleague/flysystem-sftp
• Zip (through ZipArchive): https://github.com/thephpleague/flysystem-ziparchive
• WebDAV (through SabreDAV): https://github.com/thephpleague/flysystem-webdav
• PHPCR: https://github.com/thephpleague/flysystem-phpcr
• Azure Blob Storage
• NullAdapter

Caching

• Memory (array caching)
• Redis (through Predis)
• Memcached
• Adapter
• Stash

Documentation

Check out the documentation

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.