File Handling

By default, CRUDlex uses the filesystem to store uploaded files. The current working directory is taken as root here. Usually, this is the path to your index.php. So this example stores the image files under <workingDirectory>/uploads

library:
    table: lib
    label: Library
    fields:
        image:
            type: file
            path: uploads

One big drawback here is that the application is not stateless anymore according to https://12factor.net/processes. But luckily, the file handling is done via Flysystem and the used FilesystemInterface can be overridden easily by setting a service called “crud.filesystem”.

In any way, overriding or not, the underlying FilesystemInterface is available via

$app['crud.filesystem']

Overriding the Default Storage with Amazon S3 as Filesystem

Here is an example of using Amazon S3 as storage.

First, get the AwsS3Adapter:

composer require league/flysystem-aws-s3-v3

And then configure it and hand it over to CRUDlex:

$client = S3Client::factory([
    'credentials' => [
        'key'    => $key,
        'secret' => $secret
    ],
    'region' => $region,
    'version' => 'latest',
]);
$adapter = new \League\Flysystem\AwsS3v3\AwsS3Adapter($client, $bucket);
$filesystem = new \League\Flysystem\Filesystem($adapter);
$dataFactory = new \CRUDlex\MySQLDataFactory($app['db']);
$app->register(new \CRUDlex\ServiceProvider(), array(
    'crud.file' => __DIR__ . '/../crud.yml',
    'crud.datafactory' => $dataFactory,
    'crud.filesystem' => $filesystem,
));

Filesystem Storage Adapters

Many more adapters are available for Flysystem, including (as of writing):

  • Local
  • Azure
  • AWS S3 V2
  • AWS S3 V3
  • Copy.com
  • Dropbox
  • FTP
  • GridFS
  • Memory
  • Null / Test
  • Rackspace
  • ReplicateAdapter
  • SFTP
  • WebDAV
  • PHPCR
  • ZipArchive

See the Flysystem page for their usage.