Flysystem adapter for OpenStack Swift

1.5.0 2023-02-27 08:16 UTC

This package is auto-updated.

Last update: 2024-04-27 11:05:43 UTC


Author Tests Software License Packagist Version Total Downloads

Flysystem adapter for OpenStack Swift.


composer require nimbusoft/flysystem-openstack-swift


$openstack = new OpenStack\OpenStack([
    'authUrl' => '{authUrl}',
    'region'  => '{region}',
    'user'    => [
        'id'       => '{userId}',
        'password' => '{password}'
    'scope'   => ['project' => ['id' => '{projectId}']]

$container = $openstack->objectStoreV1()

$adapter = new Nimbusoft\Flysystem\OpenStack\SwiftAdapter($container);

$flysystem = new League\Flysystem\Filesystem($adapter);


The Swift adapter has the following configuration options:

Uploading large objects

See more at openstack documentation

  • swiftLargeObjectThreshold: Size of the file in bytes when to switch over to the large object upload procedure. Default is 300 MiB. The maximum allowed size of regular objects is 5 GiB.
  • swiftSegmentSize: Size of individual segments or chunks that the large file is split up into. Default is 100 MiB. Should be below 5 GiB.
  • swiftSegmentContainer: Name of the Swift container to store the large object segments to. Default is the same container that stores the regular files.

Content type

  • contentType: Sets the Content-Type header of the request.
  • detectContentType: If set to true, Object Storage guesses the content type based on the file extension and ignores the value sent in the Content-Type header, if present.

File expiration

  • deleteAfter: Specifies the number of seconds after which the object is removed. Internally, the Object Storage system stores this value in the X-Delete-At metadata item.
  • deleteAt: The certain date, in the UNIX Epoch timestamp format, when the object will be removed.


These options can be set on Filesystem creation:

$flysystem = new League\Flysystem\Filesystem($adapter, new \League\Flysystem\Config([
    'swiftLargeObjectThreshold' => 104857600, // 100 MiB
    'swiftSegmentSize' => 52428800, // 50 MiB
    'swiftSegmentContainer' => 'mySegmentContainer',

or per-file:

$flysystem->write($path, $contents, new \League\Flysystem\Config([
    'swiftLargeObjectThreshold' => 52428800, // 50 MiB
    'contentType' => 'text/plain',
    'deleteAfter' => 3600, // 1 hour