PHPackages                             takethelead/laravel-storyblok-file-proxy - 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. takethelead/laravel-storyblok-file-proxy

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

takethelead/laravel-storyblok-file-proxy
========================================

File proxy for Storyblok

1.3.0(2y ago)01.4k[5 PRs](https://github.com/takethelead/laravel-storyblok-file-proxy/pulls)MITPHPPHP ^8.1|^8.2CI passing

Since Aug 5Pushed 1y ago1 watchersCompare

[ Source](https://github.com/takethelead/laravel-storyblok-file-proxy)[ Packagist](https://packagist.org/packages/takethelead/laravel-storyblok-file-proxy)[ Docs](https://github.com/takethelead/laravel-storyblok-file-proxy)[ RSS](/packages/takethelead-laravel-storyblok-file-proxy/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (8)Dependencies (10)Versions (16)Used By (0)

Laravel Storyblok File Proxy
============================

[](#laravel-storyblok-file-proxy)

[![Latest Version on Packagist](https://camo.githubusercontent.com/97be8e406fc880d7d7ace76c9ff1a16d3b437f4822037dee9d716a671ef2d3a1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f74616b657468656c6561642f6c61726176656c2d73746f7279626c6f6b2d66696c652d70726f78792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/takethelead/laravel-storyblok-file-proxy)[![GitHub Tests Action Status](https://camo.githubusercontent.com/7ecd3c50dedb026328c77beef172a2c33edf21a3a4f3d87d3d0fcf22c9a2de1a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f74616b657468656c6561642f6c61726176656c2d73746f7279626c6f6b2d66696c652d70726f78792f54657374733f6c6162656c3d7465737473)](https://github.com/takethelead/laravel-storyblok-file-proxy/actions?query=workflow%3Atests+branch%3Amaster)[![Total Downloads](https://camo.githubusercontent.com/8fe6b0b798fd2f027778c6d67aeb259868115c56534e10393a3572389ab96ffa/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f74616b657468656c6561642f6c61726176656c2d73746f7279626c6f6b2d66696c652d70726f78792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/takethelead/laravel-storyblok-file-proxy)

Convert Storyblok file urls to local urls and proxy them through your Laravel application. You can easily add extra middlewares to the proxy route, for example to add extra authorization checks.

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

[](#installation)

You can install the package via composer:

```
composer require takethelead/laravel-storyblok-file-proxy
```

You can publish the config file with:

```
php artisan vendor:publish --provider="TakeTheLead\LaravelStoryblokFileProxy\LaravelStoryblokFileProxyServiceProvider" --tag="config"
```

This is the contents of the published config file:

```
return [

    /*
    |--------------------------------------------------------------------------
    | Base url
    |--------------------------------------------------------------------------
    |
    | Define the base url to proxy files through.
    |
    | Ex. 'files' will result in https://appurl.test/files/{fileSlug}
    |
    */

    'base_url' => 'files',

    /*
    |--------------------------------------------------------------------------
    | Middleware
    |--------------------------------------------------------------------------
    |
    | Define the route middleware (groups) where the proxy route should be
    | wrapped in.
    |
    |
    */

    'middleware' => [
        'web',
    ],

    /*
    |--------------------------------------------------------------------------
    | Proxy urls
    |--------------------------------------------------------------------------
    |
    | Define all url types that should be formatted. Each proxy should
    | have at least a "type" and "url" property. The defined base url
    | will be swapped with a local url.
    |
    */

    'proxy_urls' => [
        [
            'type' => 'images',
            'url' => 'https://img2.storyblok.com',
        ],
        [
            'type' => 'other',
            'url' => 'https://a.storyblok.com',
        ],
    ],

];
```

Usage
-----

[](#usage)

### Proxy route

[](#proxy-route)

The package will proxy files through the application, therefore it registers a route in the application. You can define a custom base slug in the config file, this way you can prevent collision with your existing routes.

Through the config file you can also specify the route middleware (groups) that should be applied to the route.

### Convert Storyblok urls to local urls

[](#convert-storyblok-urls-to-local-urls)

```
\StoryblokUrl::toLocal($file['filename']);
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

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

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Joren Van Hocht](https://github.com/jorenvh)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance32

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 50.9% 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 ~164 days

Recently: every ~284 days

Total

8

Last Release

953d ago

Major Versions

0.0.3 → 1.0.02020-08-20

PHP version history (3 changes)0.0.1PHP ^7.4

1.2.0PHP ^8.0|^8.1

1.3.0PHP ^8.1|^8.2

### Community

Maintainers

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

---

Top Contributors

[![jorenvh](https://avatars.githubusercontent.com/u/8791625?v=4)](https://github.com/jorenvh "jorenvh (27 commits)")[![RenoSimonsTTL](https://avatars.githubusercontent.com/u/135593384?v=4)](https://github.com/RenoSimonsTTL "RenoSimonsTTL (14 commits)")[![StevenSteel](https://avatars.githubusercontent.com/u/1955692?v=4)](https://github.com/StevenSteel "StevenSteel (11 commits)")[![giannibrws](https://avatars.githubusercontent.com/u/22145578?v=4)](https://github.com/giannibrws "giannibrws (1 commits)")

---

Tags

taketheleadlaravel-storyblok-file-proxy

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/takethelead-laravel-storyblok-file-proxy/health.svg)

```
[![Health](https://phpackages.com/badges/takethelead-laravel-storyblok-file-proxy/health.svg)](https://phpackages.com/packages/takethelead-laravel-storyblok-file-proxy)
```

###  Alternatives

[unisharp/laravel-filemanager

A file upload/editor intended for use with Laravel 5 to 10 and CKEditor / TinyMCE

2.2k3.3M74](/packages/unisharp-laravel-filemanager)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

71510.9M66](/packages/laravel-mcp)[psalm/plugin-laravel

Psalm plugin for Laravel

3274.9M308](/packages/psalm-plugin-laravel)[josiasmontag/laravel-recaptchav3

Recaptcha V3 for Laravel package

2641.6M2](/packages/josiasmontag-laravel-recaptchav3)[stechstudio/laravel-zipstream

A fast and simple streaming zip file downloader for Laravel.

4633.7M3](/packages/stechstudio-laravel-zipstream)

PHPackages © 2026

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