Storage

Default Configuration (Local Storage)

By default, Pushword stores media files locally in your media_dir (configured in pushword.yaml):

pushword:
  media_dir: '%kernel.project_dir%/media'
  public_media_dir: media

This works out of the box with no additional configuration.

Using Remote Storage (S3, FTP, etc.)

To use a remote storage backend, you need to:

1. Install the appropriate Flysystem adapter
2. Override the Flysystem configuration in your application

Example: Amazon S3 Storage

1. Install the S3 adapter:

composer require league/flysystem-aws-s3-v3

2. Create config/packages/flysystem.yaml in your project:

flysystem:
  storages:
    pushword.mediaStorage:
      adapter: 'aws'
      options:
        client: 'aws_client_service'
        bucket: 'your-bucket-name'
        prefix: 'media'

3. Configure the AWS client service (see Flysystem Bundle documentation).

Example: FTP Storage

1. Install the FTP adapter:

composer require league/flysystem-ftp

2. Create config/packages/flysystem.yaml:

flysystem:
  storages:
    pushword.mediaStorage:
      adapter: 'ftp'
      options:
        host: 'ftp.example.com'
        username: '%env(FTP_USERNAME)%'
        password: '%env(FTP_PASSWORD)%'
        root: '/path/to/media'

Advanced: Custom MediaStorageAdapter

If you need to customize how Pushword interacts with storage, you can override the MediaStorageAdapter service:

// config/services.php
use Pushword\Core\Service\MediaStorageAdapter;

$services->set(MediaStorageAdapter::class)
    ->args([
        '$storage' => service('pushword.mediaStorage'),
        '$mediaDir' => '%pw.media_dir%',
        '$isLocal' => false, // Set to false for remote storage
    ]);

The isLocal parameter is important for performance:

• true (default): Uses direct filesystem paths for image processing
• false: Downloads files to temp directory before processing (required for remote storage)

Available Adapters

Flysystem supports many storage backends:

See the Flysystem documentation for complete configuration options.

Notes

• Image cache (thumbnails, optimized versions) is always stored locally in public/{public_media_dir}/ for direct browser access
• When using remote storage, original media files are downloaded temporarily for image processing
• VichUploaderBundle is configured to use Flysystem for uploads