PHPackages                             bravesheep/flysystem-url-bundle - 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 &amp; Storage](/categories/file-storage)
4. /
5. bravesheep/flysystem-url-bundle

AbandonedArchivedLibrary[File &amp; Storage](/categories/file-storage)

bravesheep/flysystem-url-bundle
===============================

FlySystem URL bundle generates services for flysystem by specifying a url parameter

v0.1.1(9y ago)13.3k1MITPHPPHP &gt;=5.6.0

Since May 24Pushed 9y ago2 watchersCompare

[ Source](https://github.com/bravesheep/flysystem-url-bundle)[ Packagist](https://packagist.org/packages/bravesheep/flysystem-url-bundle)[ RSS](/packages/bravesheep-flysystem-url-bundle/feed)WikiDiscussions master Synced yesterday

READMEChangelog (1)Dependencies (4)Versions (3)Used By (1)

BravesheepFlysystemUrlBundle
============================

[](#bravesheepflysystemurlbundle)

A [Symfony](https://symfony.com/) bundle that creates flysystem services based upon a url specified in the symfony configuration.

Installation and configuration
------------------------------

[](#installation-and-configuration)

Using [Composer](https://getcomposer.org/) add the bundle to your dependencies using the require command: `composer require bravesheep/flysystem-url-bundle`.

Add the bundle to your AppKernel
--------------------------------

[](#add-the-bundle-to-your-appkernel)

Add the bundle in your `app/AppKernel.php`. **Note**: in order for the parameters defined by this bundle to be picked up by other bundles using them you need to put it before those bundles. See below for more information.

```
public function registerBundles()
{
    return array(
        // ...
        new Bravesheep\FlysystemUrlBundle\BravesheepFlysystemUrlBundle(),
        // ...
    );
}
```

Configure the bundle
--------------------

[](#configure-the-bundle)

For this bundle you need to configure which urls should be used and what the service names should be for the generated services. An example configuration is shown below where the `media_fs_url` parameter (which you can put in your `parameters.yml` for example) generates a flysystem adapter service for you to use.

```
bravesheep_flysystem_url:
    urls:
        # Generates media_fs_adapter.adapter service
        media:
            url: %media_fs_url%
            prefix: media_fs_adapter
```

Accepted urls
-------------

[](#accepted-urls)

Several url formats are accepted, a short overview of supported urls is shown below:

- `local:///path/to/directory` or `file:///path/to/directory` for local filesystem storage. In case of local urls an absolute path is required. Use for example the `kernel.root_dir` parameter: `file://%kernel.root_dir%/../web/media`. The `lock` query parameter may be used to indicate different locking behavior: `local:///path/to/directory?lock=false`. Public file permissions may be set using the `file_perm` parameter: `local:///path/to/directory?file_perm=0744`. Similarly the `file_perm_private`, `dir_perm` and `dir_perm_private` parameters are available.
- `ftp://user:pass@host:port/path/to/dir` for FTP usage. Alternatively `ftps` scheme may be used for SSL secured FTP.
- `sftp://user:pass@host:port/path/to/dir?keyfile=path/to/keyfile` or alternatively the `ssh` scheme may be specified for the same behavior.
- `dropbox://access_token:app_secret@dropbox.com` for Dropbox access.
- `s3://key:secret@region/bucket` for Amazon AWS S3. Alternatively the `awss3` and `awss3v3` schemes are available. For the v2 version of the AWS API you may use `awss3v2` as a scheme.
- `null://` or just `null` may be specified for a testing storage adapter which does not store anything.
- `zip:///path/to/file.zip` may be used for local zip access.
- `webdav://user:pass@host:port/path/to/dir` may be used for WebDAV access. Alternatively `http://user:pass@host:port/path/to/dir` or `https://user:pass@host:port/path/to/dir` may be used as well.

Extra variable encodings
------------------------

[](#extra-variable-encodings)

By default this bundle does not just create a flysystem adapter service but can also generate some extra parameters which you can directly use.

The bundle by default generates a parameter you can use in the OneupFlysystemBundle as a value for your adapter:

```
oneup_flysystem:
    adapters:
        media_adapter: %media_fs_adapter.oneup_adapter_params%
```

By default the bundle also generates a public prefix url for some services if it can determine that url automatically. You could use this for example with the VichUploaderBundle:

```
vich_uploader:
    mappings:
        example:
            upload_destination: media_fs
            uri_prefix: %media_fs_adapter.public_url_prefix%
```

If you don't need these parameters you can change them in the configuration of this bundle:

```
bravesheep_flysystem_url:
    urls:
        example:
            url: %example_param%
            prefix: example_fs_prefix
            encoders: [] # In this case no parameter encoders are used, only the service is generated
```

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% of commits — single point of failure

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 ~57 days

Total

2

Last Release

3631d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/86a9633404b0317dcde9ecb9c54f88c4d54bc42bb137d462933773bbe3a539b9?d=identicon)[rnijveld](/maintainers/rnijveld)

![](https://www.gravatar.com/avatar/664f27a4241e63b3e2cff68a436e2ef6930c926dd0ae0fb4973bfb969cab1754?d=identicon)[marlon](/maintainers/marlon)

---

Top Contributors

[![rnijveld](https://avatars.githubusercontent.com/u/193783?v=4)](https://github.com/rnijveld "rnijveld (4 commits)")[![marlonbaeten](https://avatars.githubusercontent.com/u/885089?v=4)](https://github.com/marlonbaeten "marlonbaeten (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bravesheep-flysystem-url-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/bravesheep-flysystem-url-bundle/health.svg)](https://phpackages.com/packages/bravesheep-flysystem-url-bundle)
```

PHPackages © 2026

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