PHPackages                             weboptic/flysystem-bunnycdn - 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. weboptic/flysystem-bunnycdn

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

weboptic/flysystem-bunnycdn
===========================

Flysystem adapter for BunnyCDN

v3.0.2(4y ago)040MITPHP

Since Dec 8Pushed 4y agoCompare

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

READMEChangelog (1)Dependencies (7)Versions (30)Used By (0)

[![Bunny CDN Logo](https://gist.githubusercontent.com/sifex/bb1ebae00c4c9a827a55a2b973fef0e7/raw/d79dab1b6959f580a3b7a2e6238dae7445203f2a/bunnycdn_logo.svg?sanitize=true)](https://gist.githubusercontent.com/sifex/bb1ebae00c4c9a827a55a2b973fef0e7/raw/d79dab1b6959f580a3b7a2e6238dae7445203f2a/bunnycdn_logo.svg?sanitize=true)

Flysystem Adapter for BunnyCDN Storage
======================================

[](#flysystem-adapter-for-bunnycdn-storage)

[![Build Status - Flysystem v1](https://camo.githubusercontent.com/dfb3b061060707696ffe498c1cbf51a7094681fdf11b973d390e8f249e38ad6a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f506c6174666f726d436f6d6d756e6974792f666c7973797374656d2d62756e6e7963646e2f6275696c642f76313f6c6162656c3d466c7973797374656d2532307631266c6f676f3d676974687562)](https://github.com/PlatformCommunity/flysystem-bunnycdn/actions) [![Build Status - Flysystem v1](https://camo.githubusercontent.com/c50322ceda80dba7df61207804b4843eba44db2026a8e9be909d6f0029d1b90c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f506c6174666f726d436f6d6d756e6974792f666c7973797374656d2d62756e6e7963646e2f6275696c642f76323f6c6162656c3d466c7973797374656d2532307632266c6f676f3d676974687562)](https://github.com/PlatformCommunity/flysystem-bunnycdn/actions) [![Build Status - Flysystem v1](https://camo.githubusercontent.com/ef2306521e016f895e5fbf54a5887b20cbf76dfdbd4febc63e4fffa80f45a8b1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f506c6174666f726d436f6d6d756e6974792f666c7973797374656d2d62756e6e7963646e2f6275696c642f76333f6c6162656c3d466c7973797374656d2532307633266c6f676f3d676974687562)](https://github.com/PlatformCommunity/flysystem-bunnycdn/actions)
[![Codecov](https://camo.githubusercontent.com/04c1cb82413b886cce349ab2c6fdcc95fc1333225f852070ccb109c967e1a3f4/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f506c6174666f726d436f6d6d756e6974792f666c7973797374656d2d62756e6e7963646e)](https://codecov.io/gh/PlatformCommunity/flysystem-bunnycdn) [![Packagist Version](https://camo.githubusercontent.com/200e891a9316273ad92c22a8b9056626ea06e4cb794c614cb8bcdb4a5012d218/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f706c6174666f726d636f6d6d756e6974792f666c7973797374656d2d62756e6e7963646e)](https://packagist.org/packages/platformcommunity/flysystem-bunnycdn) [![Minimum PHP Version: 7.4](https://camo.githubusercontent.com/df31d339fd7a30cdfa120790cf1c9f4ad1c46ced156acf25038cbbcf7b2ed8c7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d6d696e253230372e342d696d706f7274616e74)](https://camo.githubusercontent.com/df31d339fd7a30cdfa120790cf1c9f4ad1c46ced156acf25038cbbcf7b2ed8c7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d6d696e253230372e342d696d706f7274616e74) [![Licence: MIT](https://camo.githubusercontent.com/03309b7fb1fa8e4d495ae49da44444e2ddf748b26fc94389e591258dc350aaac/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f706c6174666f726d636f6d6d756e6974792f666c7973797374656d2d62756e6e7963646e)](https://github.com/PlatformCommunity/flysystem-bunnycdn/blob/master/LICENSE) [![Downloads](https://camo.githubusercontent.com/9de9f9fa6010ce25ceb49803c3e98b686ab2cb435b1e928a558c0afffe5ad2ff/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f706c6174666f726d636f6d6d756e6974792f666c7973797374656d2d62756e6e7963646e)](https://packagist.org/packages/platformcommunity/flysystem-bunnycdn)

⚠️ Note – Breaking Change
-------------------------

[](#️-note--breaking-change)

> ⚠️ (21/Feb/22) As the upstream BunnyCDNStorage client has gone sometime without an update, it's become unsustainable to continue to use. For all updates, simply change the `BunnyCDNStorage` to `BunnyCDNClient` and re-import. ⚠️

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

[](#installation)

To install `flysystem-bunnycdn`, require the package with no version constraint. This should match the `flysystem-bunnycdn` version with your version of FlySystem (v1, v2, v3 etc).

```
composer require platformcommunity/flysystem-bunnycdn "*"
```

Usage
-----

[](#usage)

```
use BunnyCDN\Storage\BunnyCDNClient;
use League\Flysystem\Filesystem;
use PlatformCommunity\Flysystem\BunnyCDN\BunnyCDNAdapter;
use PlatformCommunity\Flysystem\BunnyCDN\BunnyCDNRegion;

$adapter = new BunnyCDNAdapter(
    new BunnyCDNClient(
        'storage-zone',
        'api-key',
        BunnyCDNRegion::FALKENSTEIN
    )
);

$filesystem = new Filesystem($adapter);
```

### Usage with Pull Zones

[](#usage-with-pull-zones)

To have BunnyCDN adapter publish to a public CDN location, you have to a "Pull Zone" connected to your BunnyCDN Storage Zone. Add the full URL prefix of your Pull Zone (including `http://`/`https://`) to the BunnyCDNAdapter parameter like shown below.

```
use BunnyCDN\Storage\BunnyCDNClient;
use League\Flysystem\Filesystem;
use PlatformCommunity\Flysystem\BunnyCDN\BunnyCDNAdapter;
use PlatformCommunity\Flysystem\BunnyCDN\BunnyCDNRegion;

$adapter = new BunnyCDNAdapter(
    new BunnyCDNClient(
        'storage-zone',
        'api-key',
        BunnyCDNRegion::FALKENSTEIN
    ),
    'https://testing.b-cdn.net/' # Pull Zone URL
);
$filesystem = new Filesystem($adapter);
```

*Note: You can also use your own domain name if it's configured in the pull zone.*

Once you add your pull zone, you can use the `->getUrl($path)`, or in Laravel, the `->url($path)` command to get the fully qualified public URL of your BunnyCDN assets.

Usage in Laravel 9
------------------

[](#usage-in-laravel-9)

For a guide on how to use `flysystem-bunnycdn` in Laravel 9, follow the guide here:

Regions
-------

[](#regions)

For a full region list, please visit the [BunnyCDN API documentation page](https://docs.bunny.net/reference/storage-api#storage-endpoints).

`flysystem-bunnycdn` also comes with constants for each region located within `PlatformCommunity\Flysystem\BunnyCDN\BunnyCDNRegion`.

### List of Regions

[](#list-of-regions)

```
BunnyCDNRegion::FALKENSTEIN = 'de';
BunnyCDNRegion::NEW_YORK = 'ny';
BunnyCDNRegion::LOS_ANGELAS = 'la';
BunnyCDNRegion::SINGAPORE = 'sg';
BunnyCDNRegion::SYDNEY = 'syd';
BuunyCDNRegion::UNITED_KINGDOM = 'uk';
```

Contributing
------------

[](#contributing)

Pull requests welcome. Please feel free to lodge any issues as discussion points.

Licence
-------

[](#licence)

The Flysystem adapter for Bunny.net is licensed under [MIT](https://github.com/PlatformCommunity/flysystem-bunnycdn/blob/master/LICENSE).

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 90.8% 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 ~32 days

Recently: every ~5 days

Total

27

Last Release

1525d ago

Major Versions

v1.0.0 → v2.0.02022-01-14

v1.1.0 → v2.1.12022-01-14

v1.1.1 → v3.0.0-alpha-12022-02-21

v2.2.0 → v3.x-dev2022-02-21

v1.x-dev → v3.0.22022-03-15

### Community

Maintainers

![](https://www.gravatar.com/avatar/b179919d269900984b1719c506bdfa49a5f3dd3e2faf2edef5b775377db3a787?d=identicon)[weboptic](/maintainers/weboptic)

---

Top Contributors

[![sifex](https://avatars.githubusercontent.com/u/2058557?v=4)](https://github.com/sifex "sifex (79 commits)")[![shanedeakin](https://avatars.githubusercontent.com/u/1687089?v=4)](https://github.com/shanedeakin "shanedeakin (5 commits)")[![jjprojects](https://avatars.githubusercontent.com/u/32326340?v=4)](https://github.com/jjprojects "jjprojects (1 commits)")[![n-e-m-a-nj-a](https://avatars.githubusercontent.com/u/3234686?v=4)](https://github.com/n-e-m-a-nj-a "n-e-m-a-nj-a (1 commits)")[![stof](https://avatars.githubusercontent.com/u/439401?v=4)](https://github.com/stof "stof (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/weboptic-flysystem-bunnycdn/health.svg)

```
[![Health](https://phpackages.com/badges/weboptic-flysystem-bunnycdn/health.svg)](https://phpackages.com/packages/weboptic-flysystem-bunnycdn)
```

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[google/cloud

Google Cloud Client Library

1.2k16.2M53](/packages/google-cloud)[stechstudio/laravel-zipstream

A fast and simple streaming zip file downloader for Laravel.

4633.7M3](/packages/stechstudio-laravel-zipstream)[masbug/flysystem-google-drive-ext

Flysystem adapter for Google Drive with seamless virtual&lt;=&gt;display path translation

2631.7M14](/packages/masbug-flysystem-google-drive-ext)[league/flysystem-sftp-v3

SFTP filesystem adapter for Flysystem.

6129.6M91](/packages/league-flysystem-sftp-v3)[dgtlss/capsule

A Laravel package for backing up databases and files to external sources with notifications

194.3k](/packages/dgtlss-capsule)

PHPackages © 2026

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