PHPackages                             nimbusoft/flysystem-openstack-swift - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. nimbusoft/flysystem-openstack-swift

ActiveLibrary[File & Storage](/categories/file-storage)

nimbusoft/flysystem-openstack-swift
===================================

Flysystem adapter for OpenStack Swift

1.5.0(3y ago)44774.4k—0.7%20[1 issues](https://github.com/chrisnharvey/flysystem-openstack-swift/issues)6MITPHPPHP ^7.4 | ^8.0

Since Aug 26Pushed 3y ago5 watchersCompare

[ Source](https://github.com/chrisnharvey/flysystem-openstack-swift)[ Packagist](https://packagist.org/packages/nimbusoft/flysystem-openstack-swift)[ RSS](/packages/nimbusoft-flysystem-openstack-swift/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (6)Versions (21)Used By (6)

Flysystem Adapter for OpenStack Swift
=====================================

[](#flysystem-adapter-for-openstack-swift)

[![Author](https://camo.githubusercontent.com/8faa47357cbdeea7900815137d56d4c452ce5e052a66e5acea2b2dfd5dbb76fb/687474703a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d4063687269736e6861727665792d626c75652e737667)](https://twitter.com/chrisnharvey)[![Tests](https://github.com/chrisnharvey/flysystem-openstack-swift/actions/workflows/tests.yml/badge.svg)](https://github.com/chrisnharvey/flysystem-openstack-swift/actions/workflows/tests.yml)[![Software License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](LICENSE)[![Packagist Version](https://camo.githubusercontent.com/44b29326507df0b6757220dd8833e3326e132fcf8b27c1ffda31bb19973d5c2f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e696d6275736f66742f666c7973797374656d2d6f70656e737461636b2d73776966742e737667)](https://packagist.org/packages/nimbusoft/flysystem-openstack-swift)[![Total Downloads](https://camo.githubusercontent.com/3c351b73e476f4b1e9544f4beaf978b590575c93ce0265705a2bba2851dffdce/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e696d6275736f66742f666c7973797374656d2d6f70656e737461636b2d73776966742e737667)](https://packagist.org/packages/nimbusoft/flysystem-openstack-swift)

Flysystem adapter for OpenStack Swift.

Installation
------------

[](#installation)

```
composer require nimbusoft/flysystem-openstack-swift
```

Usage
-----

[](#usage)

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

$container = $openstack->objectStoreV1()
    ->getContainer('{containerName}');

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

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

Configuration
-------------

[](#configuration)

The Swift adapter has the following configuration options:

### Uploading large objects

[](#uploading-large-objects)

See more at [openstack documentation](https://php-opencloudopenstack.readthedocs.io/en/latest/services/object-store/v1/objects.html#create-a-large-object-over-5gb)

- `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

[](#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

[](#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.

### Examples

[](#examples)

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
])
```

###  Health Score

48

—

FairBetter than 95% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity51

Moderate usage in the ecosystem

Community29

Small or concentrated contributor base

Maturity77

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~125 days

Recently: every ~82 days

Total

20

Last Release

1176d ago

Major Versions

0.4.1 → 1.0.02022-02-17

PHP version history (3 changes)0.4.0PHP >=7.3

1.0.0PHP >= 7.4

1.1.0PHP ^7.4 | ^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/619298?v=4)[Chris Harvey](/maintainers/chrisnharvey)[@chrisnharvey](https://github.com/chrisnharvey)

---

Top Contributors

[![chrisnharvey](https://avatars.githubusercontent.com/u/619298?v=4)](https://github.com/chrisnharvey "chrisnharvey (67 commits)")[![mzur](https://avatars.githubusercontent.com/u/2457311?v=4)](https://github.com/mzur "mzur (40 commits)")[![drupol](https://avatars.githubusercontent.com/u/252042?v=4)](https://github.com/drupol "drupol (7 commits)")[![sausin](https://avatars.githubusercontent.com/u/11542923?v=4)](https://github.com/sausin "sausin (6 commits)")[![Y0lk](https://avatars.githubusercontent.com/u/1523444?v=4)](https://github.com/Y0lk "Y0lk (4 commits)")[![k0ka](https://avatars.githubusercontent.com/u/203597?v=4)](https://github.com/k0ka "k0ka (4 commits)")[![4c0n](https://avatars.githubusercontent.com/u/2325383?v=4)](https://github.com/4c0n "4c0n (4 commits)")[![mrwogu](https://avatars.githubusercontent.com/u/2917861?v=4)](https://github.com/mrwogu "mrwogu (3 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (2 commits)")[![jeroenlammerts](https://avatars.githubusercontent.com/u/4282711?v=4)](https://github.com/jeroenlammerts "jeroenlammerts (1 commits)")[![bradjones1](https://avatars.githubusercontent.com/u/981966?v=4)](https://github.com/bradjones1 "bradjones1 (1 commits)")

---

Tags

filesystemFlysystemfilesstoragefilesystemsOpenstackswiftopencloudchrisnharvey

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nimbusoft-flysystem-openstack-swift/health.svg)

```
[![Health](https://phpackages.com/badges/nimbusoft-flysystem-openstack-swift/health.svg)](https://phpackages.com/packages/nimbusoft-flysystem-openstack-swift)
```

###  Alternatives

[league/flysystem

File storage abstraction for PHP

13.6k639.1M2.2k](/packages/league-flysystem)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[sausin/laravel-ovh

OVH Object Storage driver for laravel

40153.5k](/packages/sausin-laravel-ovh)[league/flysystem-sftp-v3

SFTP filesystem adapter for Flysystem.

6129.6M91](/packages/league-flysystem-sftp-v3)[league/flysystem-async-aws-s3

AsyncAws S3 filesystem adapter for Flysystem.

2610.5M31](/packages/league-flysystem-async-aws-s3)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)