adapter_awss3.md

Use the AwsS3 adapter

There are two AwsS3 adapters that you can use with this bundle. Below is the configuration for AwsS3v3 and AwsS3v2 adapters.

AwsS3v3

In order to use the AwsS3v3 adapter, you first need to create a client object defined as a service. This Flysystem adapter works with the aws/aws-sdk-php package version 3 and above. This version requires you to use the "v4" of the signature.

services:
    acme.s3_client:
        class: Aws\S3\S3Client
        arguments:
            -
                version: '2006-03-01' # or 'latest'
                region: "region-id" # 'eu-central-1' for example
                credentials:
                    key: "s3-key"
                    secret: "s3-secret"

Set this service as the value of the client key in the oneup_flysystem configuration.

oneup_flysystem:
    adapters:
        acme.flysystem_adapter:
            awss3v3:
                client: acme.s3_client
                bucket: 'bucket-name'
                prefix: 'path/prefix' # Optional path prefix, you can set empty string

For more details on the other parameters, take a look at the Flysystem documentation.

Additional parameters

Use options config to pass additional parameters to AWS.

Example use case

Sending files to S3 bucket owned by another AWS account. In this situation default ACL value, which is private, prevents bucket owner from viewing the file.

To allow bucket owner full control over an object use below config example:

oneup_flysystem:
    adapters:
        acme.flysystem_adapter:
            awss3v3:
                client: acme.s3_client
                bucket: 'bucket-name'
                prefix: 'path/prefix' # Optional path prefix, you can set empty string
                options:
                    ACL: bucket-owner-full-control

More to know

• Create and use your filesystem